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About This Document 


Purpose 


This manual aims to supplement information contained in the User’s Reference 
Manual and the Programmer’s Reference Manual to provide an easy reference 
volume for those who must administer a Unisys System V operating system. 


Scope 


This manual describes the maintenance commands, application programs, special 
files, and procedures of the operating system. 


Audience 


The audience for this manual includes all system administrators, programmers, 
and system support personnel. 


Prerequisites 


The user of this manual should have a background in the Unisys System V 
operating system or another operating system derived from a UNIX® operating 
system. 


UNIX is a registered trademark of AT&T in the USA and other countries. 
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How to Use This Document 


The commands are divided into the following sections: 


1M. System Administration Commands 
Ke Special Files about Specific Hardware Peripherals 
8. Introduction to System Maintenance Procedures 


Each section begins with a page labeled intro(N). Entries following the intro(N) 
page are arranged alphabetically and may consist of more than one page. Some 
man pages describe several routines, procedures, etc. In such cases, the man 
page appears only once, alphabetized under its primary name. 


References with numbers other than those mentioned previously are contained in 
the appropriate section of another manual. References with a (1) or (1G) 
following the command name mean that it is contained either in the 
Programmer’s Reference Manual or the User’s Reference Manual and those 
followed by (1C) are found exclusively in the User’s Reference Manual. 


Organization 


This manual contains the following sections: 
Permuted Index 


The index derives from the "Table of Contents." It consists of a list of keywords 
in the middle column, together with the context found with the keyword. 
Keywords consist of either topical keywords or the names of commands. 
Commands show their section numbers in parentheses. The right column lists 
the name of the manual page on which each keyword may be found. The left 
column contains useful information about the keyword. 


Section 1M. System Administration Commands and Application Programs 


This section contains commands and programs devoted to administering the 
Unisys System V operating system. These entries carry a sub-class designation of 
"1M" for cross-referencing purposes. 


Section 7. Special Files 


This section describes the characteristics of system files that refer to specific 
hardware peripherals. The names in this section generally refer to device names 
for the hardware, rather than to the names of the special files themselves. These 
entries carry a sub-class designation of "7" for cross-referencing purposes. 
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Section 8. Introduction to System Maintenance Procedures 


Section 8 includes programs for system maintenance. These entries carry a sub- 
class designation of "8" for cross-referencing purposes. 


Entries for All Sections 


All entries are based on a common format, but each section does not always 
appear: 


° The NAME section gives the name(s) of the entry and briefly states its 
purpose. 


e The SYNOPSIS section summarizes the use of the program being described. 
Several conventions apply, particularly in Section 1M. 


— Boldface strings are literals. Type them just as they appear. 


— Italic strings usually represent substitutable argument prototypes and 
program names found elsewhere in the manual. 


— Square brackets [] around an argument prototype indicate an optional 
argument. When an argument prototype appears as "name" or "file," it 
always refers to a file name. 


— Ellipses ... show that the previous argument prototype may be repeated. 
e The DESCRIPTION provides an overview of the utility. 
e The EXAMPLES section gives examples of usage, where appropriate. 
e The FILES section gives the filenames built into the program. 


e The EXIT CODES section identifies values set when named commands 
terminate. 


° The NOTES and CAVEATS sections provide information that could be 
helpful under described circumstances. 


e The SEE ALSO section gives pointers to related information. 


° The DIAGNOSTICS section discusses the diagnostic messages that may 
appear. Self-explanatory messages are not listed. 


e The WARNINGS section points out potential pitfalls. 


e The BUGS section discloses known bugs and names occasional deficiencies. 
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¢ The RESTRICTIONS section reports on known restrictions and deficiencies. 
Occasionally, the suggested fix is also described. 


WO 


Related Product Information 


User’s Reference Manual 
Programmer’s Reference Manual 
Administration Guide 

Network Programmer’s Guide 
STREAMS Programmer’s Guide 
STREAMS Primer 
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NAME 
intro - introduction to maintenance commands and application programs 


DESCRIPTION 
This section describes, in alphabetical order, commands that are used chiefly for 
system maintenance and administration purposes. The commands in this section 
should be used along with those listed in Section 1 of the User’s Reference 
Manual and Sections 1, 2, 3, 4, and 5 of the Programmer’s Reference Manual. 
References of the form name(1), (2), (3), (4) and (5) refer to entries in the above 
manuals. References of the form name(1M), name(7) or name(8) refer to 
entries in this manual. 


COMMAND SYNTAX 
Unless otherwise noted, commands described in this section accept options and 
other arguments according to the following syntax: 


name [option (s)] [cmdarg(s)] 


where: 
name The name of an executable file. 
option - noargletter(s) or 
- argletter < >optarg 
where < > is optional white space. 
noargletter A single letter representing an option without an argument. 
argletter A single letter representing an option requiring an argument. 
optarg Argument (character string) satisfying preceding argletter. 
cmdarg Pathname (or other command argument) not beginning with -, 
or - by itself indicating the standard input. 
SEE ALSO 


getopt(1) in the User’s Reference Manual 
getopt(3C) in the Programmer’s Reference Manual 


DIAGNOSTICS 
Upon termination, each command returns two bytes of status, one supplied by 
the system and giving the cause for termination, and (in the case of "normal!" 
termination) one supplied by the program [see wait(2) and exit(2)]. The former 
byte is 0 for normal termination; the latter is customarily 0 for successful 
execution and non-zero to indicate troubles such as erroneous parameters, bad or 
inaccessible data, or other inability to cope with the task at hand. It is called 
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variously "exit code", "exit status", or "return code", and is described only where 
- special conventions are involved. 


BUGS UW 


Regrettably, not all commands adhere to the aforementioned syntax. 
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NAME 
accept, reject - allow or prevent LP requests 


SYNOPSIS 
/usr/lib/accept destinations 
/usr/lib/reject [-r[reason]] destinations 


DESCRIPTION 
The command accept allows /p(1) to accept requests for the named destinations. 
A destination can be either a line printer (LP) or a class of printers. Use 
lpstat(1) to find the status of destinations. 


Reject prevents /p(1) from accepting requests for the named destinations. A 
destination can be either a printer or a class of printers. Use /pstat(1) to find the 
status of destinations. The following option is useful with reject. 


-r[reason] Associates a reason with preventing /p from accepting requests. 
This reason applies to all printers mentioned up to the next -r 
option. Reason is reported by Jp when users direct requests to the 
named destinations and by Ipstat(1). If the -r option is not present 
or the -r option is given without a reason, then a default reason is 


used. 
FILES 
/usr/spool/lp/* 
SEE ALSO 


lpadmin(1M), lpsched(1M) 
enable(1), Ip(1), Ipstat(1) in the User’s Reference Manual 
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NAME 
acct: acctdisk, acctdusg, accton, acctwtmp - overview of accounting and 
miscellaneous accounting commands 


SYNOPSIS 
/usr/lib/acct/acctdisk 


/usr/lib/acct/acctdusg [-u file] [-p file] 
/usr/lib/acct/accton [ file ] 


/usr/lib/acct/acctwtmp "reason" 


DESCRIPTION 
Accounting software is structured as a set of tools (consisting of both C programs 
and shell procedures) that can be used to build accounting systems. acctsh(1M) 
describes the set of shell procedures built on top of the C programs. 


Connect time accounting is handled by various programs that write records into 
/etc/utmp, as described in utmp(4). The programs described in acctcon(1M) 
convert this file into session and charging records, which are then summarized by 


acctmerg(1M). 


Process accounting is performed by the UNIX system kernel. Upon termination 
of a process, one record per process is written to a file (normally /usr/adm/pacct). 
The programs in acctprc(1M) summarize this data for charging purposes; 
acctcms(1M) is used to summarize command usage. Current process data may 
be examined using acctcom (1). 


Process accounting and connect time accounting [or any accounting records in 
the format described in acct(4)] can be merged and summarized into total 
accounting records by acctmerg [see tacct format in acct(4)]. prtacct [see 
acctsh(1M)] is used to format any or all accounting records. 


acctdisk reads lines that contain user ID, login name, and number of disk blocks 
and converts them to total accounting records that can be merged with other 
accounting records. 


acctdusg reads its standard input (usually from find / -print) and computes disk 
resource consumption (including indirect blocks) by login. If -u is given, records 
consisting of those filenames for which acctdusg charges no one are placed in file 
(a potential source for finding users trying to avoid disk charges). If -p is given, 
file is the name of the password file. This option is not needed if the password 
file is /etc/passwd. (See diskusg(1M) for more details.) 
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accton alone turns process accounting off. If file is given, it must be the name of 
an existing file, to which the kernel appends process accounting records [see 
acct(2) and acct(4)]. 


acctwtmp writes a utmp(4) record to its standard output. The record contains 
the current time and a string of characters that describe the reason. A record 
type of ACCOUNTING is assigned [see utmp(4)]. reason must be a string of 11 
or fewer characters, numbers, $, or spaces. For example, the following are 
suggestions for use in reboot and shutdown procedures, respectively: 


acctwtmp uname > > /etc/wtmp 
acctwtmp "file save" >> /etc/wtmp 


FILES 
/etc/passwd used for login name to user ID conversions 
/usr/lib/acct holds all accounting commands listed in 


sub-class 1M of this manual 
/usr/adm/pacct current process accounting file 
/etc/wtmp login/logoff history file 


SEE ALSO 
acctcms(1M), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), 
diskusg(1M), fwtmp(1M), runacct(1M) 
acctcom(1) in the User’s Reference Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 
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NAME 
vr" acctcms - command summary from per-process accounting records 


SYNOPSIS 
/usr/lib/acct/acctems [options] files 


DESCRIPTION 
The command acctcms reads one or more files, normally in the form described in 
acct(4). It adds all records for processes that executed identically-named 
commands, sorts them, and writes them to the standard output, normally using an 
internal summary format. The options are: 


-a__ Print output in ASCII rather than in the internal summary format. The 
output includes command name, number of times executed, total kcore- 
minutes, total CPU minutes, total real minutes, mean size (in K), mean 
CPU minutes per invocation, "hog factor", characters transferred, and 
blocks read and written, as in acctcom(1M). Output is normally sorted by 
total kcore-minutes. 

om» -c Sort by total CPU time, rather than total kcore-minutes. 
| -j | Combine all commands invoked only once under "***other". 

-n_—_ Sort by number of command invocations. 

-s_ Any filenames encountered hereafter are already in internal summary 
| format. 
-t Process all records as total accounting records. The default internal 

summary format splits each field into prime and non-prime time parts. This 

option combines the prime and non-prime time parts into a single field that 
is the total of both, and provides upward compatibility with old (i.e., UNIX 
System V) style acctcms internal summary format records. 


The following options may be used only with the -a option. 
-p Output a prime-time-only command summary. 
-o Output a non-prime (offshift) time only command summary. 


When -p and -o are used together, a combination prime and non-prime time 
report is produced. All the output summaries reflect total usage except number 
“™ of times executed, CPU minutes, and real minutes, which split into prime and 
| non-prime. 


A typical sequence for performing daily command accounting and for 
maintaining a running total is: 


acctcms file ... > today 
cp total previoustotal 
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acctcms -s today previoustotal > total 
acctcms -a -s today 


SEE ALSO 
acct(1M), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), fwtmp(1M), 
runacct(1M) 
acctcom(1) in the User’s Reference Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 


BUGS 
Unpredictable output results if -t is used on new style internal summary format 
files, or if it is not used with old style internal summary format files. 
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vr acctcon: acctcon1, acctcon2 - connect-time accounting 


SYNOPSIS 


/usr/lib/acct/acctcon1 [options] 
/usr/lib/acct/acctcon2 


DESCRIPTION 


The command acctcon1 converts a sequence of login/logoff records read from its 
standard input to a sequence of records, one per login session. Its input should 
normally be redirected from /etc/wtnp. Its output is ASCII, giving device, user 
ID, login name, prime connect time (seconds), non-prime connect time 
(seconds), session starting time (numeric), and starting date and time. The 
options are: 


-p Print input only, showing line name, login name, and time (in both numeric 
and date/time formats). 

-t §acctcon1 maintains a list of lines on which users are logged in. When it 
reaches the end of its input, it emits a session record for each line that still 
appears to be active. It normally assumes that its input is a current file, so 
that it uses the current time as the ending time for each session still in 
progress. The -t flag causes it to use, instead, the last time found in its 
input, thus assuring reasonable and repeatable numbers for non-current 
files. 

-I file 
file is created to contain a summary of line usage showing line name, 
number of minutes used, percentage of total elapsed time used, number of 
sessions charged, number of logins, and number of logoffs. This file helps 
track line usage, identify bad lines, and find software and hardware 
oddities. Hangup, termination of /ogin(1) and termination of the login shell 
each generate logoff records, so that the number of logoffs is often three to 
four times the number of sessions. See init(1M) and utmp(4). 

-0 file 

file is filled with an overall record for the accounting period, giving starting 
time, ending time, number of reboots, and number of date changes. 


acctcon2 expects as input a sequence of login session records and converts them 
into total accounting records [see tacct format in acct(4)]. 


EXAMPLES 


These commands are typically used as shown below. The file camp is created 
only for the use of acctprc(1M) commands: 
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acctconl -t -] lineuse -o reboots <wtmp sort +1n +2 > ctmp 
acctcon2 <ctmp acctmerg > ctacct 


FILES 
/etc/wtmp 


SEE ALSO 
acct(1M), acctcms(1M), acctmerg(1M), acctprc(1M), acctsh(1M), fwtmp(1M), 
init(1M), runacct(1M) 
acctcom(1), login(1) in the User’s Reference Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 


BUGS 
The line usage report is confused by date changes. Use wimpfix [see fwtmp(1M)] 
to correct this situation. 
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NAME 
a acctmerg - merge or add total accounting files 


SYNOPSIS 
/usr/lib/acct/acctmerg [options] [file] .. . 


DESCRIPTION 
The command acctmerg reads its standard input and up to nine additional files, 
all in the tacct format [see acct(4)] or an ASCII version thereof. It merges these 
inputs by adding records whose keys (normally user ID and name) are identical, 
and expects the inputs to be sorted on those keys. Options are: 


-a_ Produce output in ASCII version of tacct. 

-i Input files are in ASCII version of tacct. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-v Produce output in verbose ASCII format, with more precise notation for 
floating-point numbers. 


| EXAMPLES 
The following sequence is useful for making "repairs" to any file kept in this 
format: 


acctmerg -v <filel > file2 
Edit file2 as desired... 
acctmerg -i <file2 > filel 
SEE ALSO 
acct(1M), acctcms(1M), acctcon(1M), acetprc(1M), acctsh(1M), fwtmp(1M), 
runacct(1M) 


acctcom(1) in the User’s Reference Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 
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NAME 
acctpre: acctprcl, acctprc2 - process accounting 


SYNOPSIS 
/usr/lib/acct/acctprel [ctinp| 


/usr/lib/acct/acctpre2 


DESCRIPTION 
The command acctprc1 reads input in the form described by acct(4), adds login © 
names corresponding to user IDs, then writes for each process an ASCII line 
giving user ID, login name, prime CPU time (tics), non-prime CPU time (tics), 
and mean memory size (in memory segment units). If cfmp is given, it is 
expected to contain a list of login sessions, in the form described in acctcon (1M), 
sorted by user ID and login name. If this file is not supplied, it obtains login 
names from the password file. The information in cenp helps it distinguish 
among different login names that share the same user ID. 


acctprc2 reads records in the form written by acctprc1, summarizes them by user 
ID and name, then writes the sorted summaries to the standard output as total 
accounting records. 


These commands are typically used as shown below: 


acctprel ctmp </usr/adm/pacct acctpre2 > ptacct 


FILES 
/etc/passwd 


SEE ALSO 
acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M), acctsh(1M), cron(1M), 
fwtmp(1M), runacct(1M) 
acctcom(1) in the User’s Reference Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 


BUGS 
Although it is possible to distinguish among login names that share user IDs for 
commands run normally, it is difficult to do this for those commands run from 
cron(1M), for example. More precise conversion can be done by faking login 
sessions on the console by means of the acctwtmp program in acct(1M). 


CAVEATS 


A memory segment of the mean memory size is a unit of measure for the number 
of bytes in a logical memory segment on a particular processor. 
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NAME 
o™ -acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp, prdaily, 
prtacct, runacct, shutacct, startup, turnacct - shell procedures for accounting 


SYNOPSIS 
/usr/lib/acct/chargefee login-name number 


/usr/lib/acct/ckpacct [blocks] 
/usr/lib/acct/dodisk [-o] [files ...] 


/usr/lib/acct/lastlogin 
| /usr/lib/acet/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/acct/pretmp 
/usr/lib/acct/prdaily [-1] [-c] [ mmdd ] 
/usr/lib/acct/prtacct file [ "heading" | 
c™ /usr/lib/acct/runacct [mmdd] [mmdd state] 


/usr/lib/acct/shutacct [ "reason" ] 
/usr/lib/acct/startup 


/usr/lib/acct/turnacct on off switch 


DESCRIPTION 
The command chargefee can be invoked to charge a number of units to login- 
name. A record is written to /usr/adm/fee, to be merged with other accounting 
records during the night. 


ckpacct should be initiated by means of cron(1M). It periodically checks the size 
of /usr/adm/pacct. If the size exceeds blocks, 1000 by default, tumacct is invoked 
with argument switch. If the number of free disk blocks in the /usr file system 
falls below 500, ckpacct automatically turns off the collection of process 
accounting records using the off argument to tumacct. When at least this number 
; of blocks is restored, the accounting is activated again. This feature is sensitive 
£™ to the frequency at which ckpacct is executed, usually by cron. 


dodisk should be invoked by cron to perform the disk accounting functions. By 
default, it does disk accounting on the special files in /etc/fstab. If the -o flag 1s 
used, it does a slower version of disk accounting by login directory. files specifies 
the one or more filesystem names where disk accounting is done. If files are 
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used, disk accounting is done on these filesystems only. If the -o flag is used, files 
should be mount points of mounted filesystems. If omitted, they should be the 
special file names of mountable filesystems. 


lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, which shows 
the last date on which each person logged in. 


monacct should be invoked once each month or each accounting period. number 
indicates which month or period it is. If number is not given, it defaults to the 
current month (01-12). This default is useful if monacct is to execute using 
cron(1M) on the first day of each month. monacct creates summary files in 
/usr/adm/acct/fiscal and restarts summary files in /usr/adm/acct/sum. 


nulladm creates file with mode 664 and ensures that owner and group are adm. 
It is called by various accounting shell procedures. 


prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctcon (1M). 


prdaily is invoked by runacct to format a report of the previous day’s accounting 
data. The report resides in /usr/adm/acct/sum/rprtmmdd where mmdd is the 
month and day of the report. The current daily accounting reports may be 
printed by typing prdaily. Previous days’ accounting reports can be printed by 
using the mmdd option and specifying the exact report date desired. The -I flag 
prints a report of exceptional usage by login ID for the specified date. Previous 
daily reports are cleaned up and therefore inaccessible after each invocation of 
monacct. The -c flag prints a report of exceptional resource usage by command, 
and may be used on current day’s accounting data only. 


prtacct can be used to format and print any total accounting (tacc?) file. 


runacct performs the accumulation of connect, process, fee, and disk accounting 
on a daily basis. It also creates summaries of command usage. For more 
information, see munacct(1M). 


shutacct is invoked during a system shutdown to turn process accounting off and 
append a "reason" record to /etc/wtmp. 


startup can be called to turn the accounting on when the system is brought to a 
multi-user state. 


turnacct is an interface to accton (see acct(1M)) to turn process accounting on or 
off. The switch argument turns accounting off, moyes the current /usr/adm/pacct 
to the next free name in /usr/adm/pacctincr (where incr is a number starting with 
J and incrementing by one for each additional pacct file), then turns accounting 

back on again. This procedure is called by ckpacct and thus can be taken care of 
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by the cron and used to keep pacct to a reasonable size. acct starts and stops 
process accounting using init and shutdown accordingly. 


FILES 
/usr/adm/fee 
/usr/adm/pacct 
/usr/adm/pacct* 


/etc/wtmp 
/usr/lib/acct/ptelus.awk 


accumulator for fees 

current file for per-process accounting 
used if pacct gets large and during 
execution of daily accounting procedure 
login/logoff summary 

contains the limits for exceptional 
usage by login id 


/usr/lib/acct/ptecms.awk contains the limits for exceptional 


/usr/adm/acct/nite 
/usr/lib/acct 


/usr/adm/acct/sum 


SEE ALSO 


usage by command name 

working directory 

holds all accounting commands listed in 
sub-class 1M of this manual 

summary directory, should be saved 


acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M), acctprc(1M), cron(1M), 
diskusg(1M), fwtmp(1M), runacct(1M) 

acctcom(1) in the User’s Reference Manual 

acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 
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NAME 
ft’ adv - advertise a directory for remote access 


SYNOPSIS 
adv [-r] [-d description] resource pathname {clients...| 
adv -m resource -d description | {clients...] 
adv -m resource [-d description] ; clients... 
adv 


DESCRIPTION 
The command adv is the Remote File Sharing command used to make a resource 
from one computer available for use on other computers. The machine that 
advertises the resource is called the server, while computers that mount and use 
the resource are clients. [See mount(1M).] (A resource represents a directory, 
which could contain files, subdirectories, named pipes and devices.) 


There are three ways adv is used: 1) to advertise the directory pathname under 
the name resource so it is available to Remote File Sharing clients; 2) to modify 
mM» client and description fields for currently advertised resources; or 3) to print a list 
| of all locally-advertised resources. 


The following options are available: 


-I Restricts access to the resource to a read-only basis. The 
default is read-write access. 


-d description Provides brief textual information about the advertised 
resource. description is a single argument surrounded by 
double quotes (") and has a maximum length of 32 characters. 


resource This is the symbolic name used by the server and all authorized 
clients to identify the resource. It is limited to a maximum of 
14 characters and must be different from every other resource 
name in the domain. All characters must be printable ASCII 
characters but must not include periods (.), slashes (/), or white 
space. 


pathname This is the local pathname of the advertised resource. It is 
c™ limited to a maximum of 64 characters. This pathname cannot 
| be the mount point of a remote resource and it can only be 
advertised under one resource name. 


clients These are the names of all clients that are authorized to 
remotely mount the resource. The default is that all machines 
that can connect to the server are authorized to access the 
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resource. Valid input is of the form nodename, 
domain.nodename, domain., or an alias that represents a list of 
client names. A domain name must be followed by a period (.) 
to distinguish it from a host name. The aliases are defined in 
/etc/host.alias and must conform to the alias capability in 
mailx(1). 


-m This option modifies information for a resource that has 
already been advertised. The resource is identified by a 
resource name. Only the clients and description fields can be 
modified. (To change the pathname, resource name, or 
read/write permissions, you must unadvertise and re-advertise 
the resource). 


When used with no options, adv displays all local resources that have been 
advertised; this includes the resource name, the pathname, the description, the 
read-write status, and the list of authorized clients. The resource field has a fixed 
length of 14 characters; all others are of variable length. Fields are separated by 
two white spaces, double quotes (") surround the description, and blank lines 
separate each resource entry. 


This command may be used without options by any user; otherwise it is restricted 
to the superuser. 


Remote File Sharing must be running before adv can be used to advertise or 
modify a resource entry. 


EXIT STATUS 
If there is at least one syntactically valid entry in the clients field, a warning is 
issued for each invalid entry and the command returns a successful exit status. A 
non-zero exit status is returned if the command fails. 


ERRORS 
If (1) the network is not up and running, (2) pathname is not a directory, (3) 
pathname isn’t on a file system mounted locally, or (4) there is at least one entry 
in the clients field but none are syntactically valid, an error message is sent to 
standard error. 


FILES 
/etc/host.alias 


SEE ALSO 
mount(1M), rfstart(1M), unadv(1M) 
mailx(1) in the User’s Reference Manual 
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NAME 
-arterm - archiver for termcap data bases 


SYNOPSIS 
arterm [ alternate data base | [ option-groups] 


DESCRIPTION 
The command arterm performs archive functions [similar to ar(1)] on termcap 
data bases. 


OPTIONS 
Option fields are made up of an option identifier possibly followed by several 
parameters. The -s (silent) option may precede an option group for silent (no 
error message) operation. 


The following option groups may be specified: 


-t termname 
Test if a data base entry with an ID of termname exists. If termname exists, 
arterm returns an exit status of 0; otherwise avterm returns an exit status of 
1 


-| termname 
List the names for all entries in the termcap data base. If termname is 
specified, only those entries for that termname are listed. Multiple names 
for the same entry appear on the same line separated by colons (:). 


-d termname 
Delete the data base entry with a name of termname from the data base. 


-x termname [ -f filename | 
Extract the data base entry with a name of termname. By default the entry 
is output to standard output. If a file name is specified, the file is created 
and the data base entry written to it. 


-a termname [ -f filename | 
Append a new data base entry named fermname. The text for the new entry 
is in filename. Note that termname is used only for comparison to make 
sure duplicate entries are not appended. It is not used to name the entry. 
It is assumed that the termname parameter matches the termname in the 
specified file. 


-r termname { -f filename | 
Replace the data base entry with a name of termname with the text 
contained in the file named filename. 
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-s_ Silently perform operations. Exit status codes reflect the status of all 
operations. 


EXAMPLES 
To list all data base entry names to standard output: 


arterm -| 
To list out names for an entry named eze123: 
arterm -1 eze123 
To add a new entry to the data base: 
arterm -a xyz -f xyz-file 
To replace an entry term12: 
arterm -r term12 -t text-file 
To test if an entry with the name abcterm exists: 


arterm -t abcterm 
echo $? 


FILES 
/etc/termcap default database file 


SEE ALSO 
termcap(5) in the Programmer’s Reference Manual 


RESTRICTIONS 
Entries added or replaced in the data base are not validated. 


Operations on an invalid data base file may produce undefined results because 
the structure of the data base is not validated. 
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NAME 
badlist - produce a list of bad blocks for drive 


SYNOPSIS 
badlist -[ [ -b ] - [ odx ] ] /dew/rdsk/xsy 


DESCRIPTION 
The command badlist produces a list of currently logged bad blocks for a rigid 
disk. For each bad block, badlist issues an output line to standard output with 
the bad block number listed first, followed by a colon and the alternate block 
assigned as a replacement for the bad block. 


If the utility is invoked with no parameters, badlist issues an invocation syntax 
help line. 


The device name used as a parameter must be a character special device 
partition that has access to all disk sectors, or the firmware name; (for example, 
/dev/rdsk/0sO or 501). 


OPTIONS 
-b Output in the form b block-number. 


-d Output in decimal (default). 
-o Output in octal. 


-x Output in hexadecimal. 


SEE ALSO 
format(1M) 


EXIT STATUS 
An exit status of 1 indicates that an error occurred. An exit status of 0 indicates 
that no errors were found. 


UP-14805 | Page 1 


BADLIST (1M) 


eee 


[This page left blank.] 


Page 2 UP-14805 


fF 


BLINK (1M) 


NAME 
blink - blink fault light daemon 


SYNOPSIS 
/etc/blink 


DESCRIPTION 
The blink fault light daemon turns the system fault light on and off. Currently, 
blink is only called from errdemon(1M) when the disk usage threshold is 
exceeded. blink could also be called from other applications if desired. 


The blink fault light daemon is terminated by sending it a software kill signal [see 
kill(2)]. 


Only the superuser may start the daemon. 


SEE ALSO 
blinkstop(1M), errdemon(1M) 
kill(2) in the Programmer’s Reference Manual 
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NAME 
_blinkstop - terminate the blink fault light daemon 


SYNOPSIS 
/etc/blinkstop [ namelist ] 


DESCRIPTION 
The command blinkstop terminates the blink fault light daemon, blink(1M), by 
performing ps(1) to determine the identity of the daemon and then sending it a 
software kill signal [see signal(2)]. 


The /unix file is used as the system namelist if none is specified. 


Only the superuser may use blinkstop. 


FILES 
/unix § default system namelist 


DIAGNOSTICS 
The diagnostics produced by blinkstop are self-explanatory. 


SEE ALSO 
blink(1M) 
ps(1) in the User’s Reference Manual 
kill(2), signal(2) in the Programmer’s Reference Manual 
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NAME 
brc, bcheckrc, powerfail - system initialization procedures 


SYNOPSIS 
/etc/bre 
/etc/bcheckre 
/etc/re 
/etc/powerfail 

DESCRIPTION 


These shell procedures are executed using entries in /etc/inittab by init(1M) 
whenever the system is booted (or rebooted). 


The procedure powerfail runs whenever a system power failure is detected. 


First, the bcheckrc procedure checks the status of the root file system. If the root 
file system is found to be bad, bcheckrc repairs it. 


Then, the brc procedure clears the mounted file system table, /etc/mnttab and 
puts the entry for the root file system into the mount table. 


After these two procedures have executed, init checks for the initdefault value in 
/etc/inittab. This tells init in which run level to place the system. Depending 
upon the value of initdefault, the system is placed in the multiuser state using the 
/etc/rc2 procedure. 


Note that bcheckrc should always be executed before brc. Also, these shell 
procedures may be used for several run-level states. 


SEE ALSO 
fsck(1M), init(1M), rc2(1M), shutdown(1M) 
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NAME 
btblock - display contents of bootblock from hard disks and floppy disks 


SYNOPSIS 
btblock [ -i ][ -p mn ] device-name 


DESCRIPTION 
The command btblock reads the bootblock from the specified disk device and 
writes a formatted report to standard output. 


The device name used as a parameter must be a character special device 
partition, for example /dev/rdsk/c0d0s0, /dev/rfdsk/c0d2s0 or h501. 


If btblock is invoked with no parameter, an invocation syntax help line is issued. 


OPTIONS 
-i Display the drive identification (e.g. Drive ID: NC50). 


-pnn 
Display the size and starting location of the partition specified by nn. 


SEE ALSO 
badlist(1M), format(1M), verify(1M) 
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NAME 
-captoinfo - convert a termcap description into a terminfo description 


SYNOPSIS 


captoinfo [-v ...] [-V] [-1] [-w width] file ... 


DESCRIPTION 


The command captoinfo looks in file for termcap descriptions. For each one 
found, an equivalent terminfo(4) description is written to standard output, along 
with any comments found. A description which is expressed as relative to 
another description (as specified in the termcap tc = field) is reduced to the 
minimum superset before being output. 


If no file is given, the environment variable TERMCAP is used for the filename or 
entry. If TERMCAP is a full pathname to a file, only the terminal whose name is 
specified in the environment variable TERM is extracted from that file. If the 
environment variable TERMCAP is not set, the file /etc/termcap is read. 


-V print out tracing information on standard error as the program runs. 
Specifying additional -v options causes more detailed information to 
be printed. 

-V print out the version of the program in use on standard error and 
exit. 

-1 cause the fields to print out one to a line. Otherwise, the fields are 
printed several to a line to a maximum width of 60 characters. 

-w change the output to width characters. 


FILES 


/usr/lib/terminfo/?/* compiled terminal description database 


CAVEATS 


Certain termcap defaults are assumed to be true. For example, the bell character 
(terminfo bel) is assumed to be “G . The linefeed capability (termcap nl) 1s 
assumed to be the same for both cursor_down and scroll_forward (terminfo cud1 
and ind, respectively.) Padding information is assumed to belong at the end of 
the string. 


The algorithm used to expand parameterized information for termcap fields such 
as cursor_position (termcap cm, terminfo cup) sometimes produces a string which, 
though technically correct, may not be optimal. In particular, the rarely used 
termcap operation %n produces strings that are especially long. Most 
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occurrences of these non-optimal strings are flagged with a warning message and 
may need to be recoded by hand. 


The short two-letter name at the beginning of the list of names in a termcap 
entry, a hold-over from an earlier version of the UNIX system, has been 
removed. 


DIAGNOSTICS 
tgetent failed with return code n (reason). 
The termcap entry is not valid. In particular, check for an invalid ’tc=’ 
entry. 


unknown type given for the termcap code cc. 
The termcap description had an entry for cc whose type was not boolean, 
numeric or string. 


wrong type given for the boolean (numeric, string) termcap code cc. 
The boolean termcap entry cc was entered as a numeric or string capability. 


the boolean (numeric, string) termcap code cc is not a valid name. 
An unknown fermcap code was specified. 


tgetent failed on TERM = term. 
The terminal type specified could not be found in the termcap file. 


TERM = term: cap cc (info ii) is NULL: REMOVED 
The termcap code was specified as a null string. The correct way to cancel 
an entry is with an ’@’, as in’:bs@:’. Giving a null string could cause 
incorrect assumptions to be made by the software which uses fermcap or 
terminfo. 


a function key for cc was specified, but it already has the value wv. 
-br When parsing the ko capability, the key cc was specified as having the 
same value as the capability cc, but the key cc already had a value assigned 
to it. 


the unknown termcap name cc was specified in the ko termcap capability. 
A key was specified in the ko capability which could not be handled. 


the wi character v (info ii) has the value xx, but ma gives n. 
The ma capability specified a function key with a value different from that 
specified in another setting of the same key. 


the unknown vi key v was specified in the ma termcap capability. 
A vi(1) key unknown to captoinfo was specified in the ma capability. 
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Warning: termcap sg (nn) and termcap ug (nn) had different values. 
terminfo assumes that the sg (now xmc) and ug values were the same. 


Warning: the string produced for ii may be inefficient. 
The parameterized string being created should be rewritten by hand. 


Null termname given. 
The terminal type was null. This is given if the environment variable TERM 
is not set or is null. 


cannot open file for reading. 
The specified file could not be opened. 


SEE ALSO 
tic(1M) 
curses (3X), infocmp(1M), terminfo(4) in the Programmer’s Reference Manual 
Chapter 10 in the Programmer’s Guide 


NOTES 
captoinfo should be used to convert termcap entries to terminfo(4) entries because 
the termcap database (from earlier versions of UNIX System V) may not be 
supplied in future releases. 
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NAME 
in chroot - change root directory for a command 


| SYNOPSIS 
| /etc/chroot newroot command 


DESCRIPTION 
The command chroot causes the given command to be executed relative to the 
new root. The meaning of any initial slashes (/) in the pathnames is changed for 
the command and any of its child processes to newroot. Furthermore, upon 
execution, the initial working directory is newroot. 


| 

| Notice, however, that if you redirect the output of the command to a file: 
chroot newroot command >x 

creates the file x relative to the original root of the command, not the new one. 


The new root pathname is always relative to the current root: even if a chroot is 
currently in effect, the newroot argument is relative to the current root of the 
om running process. 


This command can be run only by the superuser. 


SEE ALSO 
cd(1) in the User’s Reference Manual 
chroot(2) in the Programmer’s Reference Manual 


BUGS 
Exercise extreme caution when you reference device files in the new root file 
system. 
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NAME 
f~ chrtbl - generate character classification and conversion tables 


SYNOPSIS 
chrtbl [ file ] 


DESCRIPTION 
The chrtbl command creates one table containing information on character 
classification, uppercase/lowercase conversion, and character set width and a 
second table with information for numeric editing. The first table is a byte-sized 
array encoded so that a table lookup can be used to determine the character 
classification of a character, to convert a character (see ctype(3C)), and to find 
the byte and screen width of a character in one of the supplementary code sets. 
The size of the array is (257*2) + 7 bytes: 257 bytes are required for the 8-bit 
code set character classification table, 257 bytes for the upper to lowercase and 
lower to uppercase conversion table, and 7 bytes for character set width 
information. The second table is 2 bytes long and is encoded so that the first byte 
is used to specify the decimal delimiter and the second byte the thousand 


c™ delimiter. 


The chrtbl command reads the user-defined character classification and 
conversion information from file and creates two output files in the current 
directory. One output file, ctype.c (a C-language source file), contains the 
257*2+7-byte array generated from processing the information from file. Review 
the content of ctype.c to verify that the array is set up as planned. (In addition, 
an application program could use ctype.c.) The first 257 bytes of the array in 
ctype.c are used for character classification. The characters used for initializing 
these bytes of the array represent character classifications defined in 
/usr/include/ctype.h. For example, L specifies that a character is lowercase and 
_S!_B specifies that the character is both a spacing character and a blank. 


The last 257 bytes of the array are used for character conversion. These bytes of 
the array are initialized so that characters for which conversion information is not 
provided are converted to themselves. When you do provide conversion 
information, the first value of the pair is stored where the second would normally 
be stored, and the second is stored in place of the first. For example, if you 

£™ provide <0x41 0x61>, then 0x61 is stored where 0x41 would normally be stored, 

| and 0x41 is stored where 0x61 would normally be stored. The last 7 bytes are 

used for character width information. Up to three supplementary code sets can 
be specified. 
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The second output file (a data file) contains the same information, but is 

structured for efficient use by the character classification and conversion 

routines; see ctype(3C). The name of the output file is the value of the character WwW 
classification LC_CTYPE read in from file. This output file must be installed in 

the /lib/locale/locale/LC_CTYPE directory under this name by the superuser or 

by a member of group bin. This file must be readable by user, group, and other; 

no other permissions should be set. To use the character classification and 

conversion tables in this file, appropriately set the LC_CTYPE category of 

setlocale(3C). 


The third output file (a data file) is created only if numeric editing information is 
specified in the input file. The name of the file is the value of the character 
classification LC_NUMERIC read from the file. This output file must be copied 
to the /lib/locale//ocale/LC_NUMERIC file by someone who is superuser or a 
member of group bin. This file must be readable by user, group, and other; no 
other permissions should be set. To use the numeric editing information in this 
file, appropriately set the LC_NUMERIC category of setlocale(3C). 


If no input file is given, or if the dash character (-) is encountered, chrtbl reads 
from standard input. L J 


The syntax of file allows the user to define the name of the data file created by 
chrtbl, the assignment of characters to character classifications, the relationship 
between uppercase and lowercase letters, and byte and screen widths for up to 
three supplementary code sets. The keywords recognized by chrtb/ are: 


LC_CTYPE name of the first data file to be created by chrtbl 

isupper character codes classified as uppercase letters 

islower character codes classified as lowercase letters 

isdigit character codes classified as numeric 

isspace character codes classified as spacing (delimiter) characters 

ispunct character codes classified as punctuation 

iscntrl character codes classified as control characters 

isblank character code for the space character a 
isxdigit character codes classified as hexadecimal digits oO 
ul relationship between upper and lowercase characters 

cswidth byte and screen width information 


Page 2 UP-14805 


CHRTBL(1M) 


LC_NUMERIC name of the second data file created by chrtb/ 
( \ numeric numeric editing information (decimal and thousand delimiters) 


Any lines with the number sign (#) in the first column are treated as comments 
and are ignored. Blank lines are also ignored. 


Characters for isupper, islower, isdigit, isspace, ispunct, iscntl, and ul can be 
represented as hexadecimal or octal constants (for example, the letter a can be 
represented as 0x61 in hexadecimal or 0141 in octal). Hexadecimal and octal 
constants may be separated by one or more space and tab characters. 


Following is the format of an input specification for cswidth (byte widths for 
supplementary code sets 2 and 3 are exclusive of the single shift characters): 


cswidth n1[[:s1][,n2[:s2][,n3[:s3]]]] 


where values are: 
nl byte width for supplementary code set 1 


sl screen width for supplementary code set 1 
| n2 byte width for supplementary code set 2 
» s2 screen width for supplementary code set 2 
n3 byte width for supplementary code set 3 
s3 screen width for supplementary code set 3 


Following is the format of an input specification for numeric: 
numeric d1[d2] 


where values are: 
di decimal delimiter 
d2 thousand delimiter 
(di and d2 are represented by graphic characters) 


The dash character (-) can indicate a range of consecutive numbers. Zero or 
more space characters can separate the dash character from the numbers. The 
backslash character (\) is used for line continuation. Only a carriage return is 
permitted after the backslash character. 


The relationship between uppercase and lowercase letters (u/) is expressed as 

c~ ordered pairs of octal or hexadecimal constants: <wuppercase_character 
lowercase_character>. These two constants can be separated by one or more 
space characters. Zero or more space characters can separate the angle brackets 
(< >) from the numbers. 
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EXAMPLES 
The following example shows an input file used to create the ASCII code set | 
definition table on a file named ascii: WW 


LC CTYPE ascii 

isupper 0x41 - 0x5a 

islower 0x61 - 0x7a 

isdigit 0x30 - 0x39 

isspace 0x20 0x9 - Oxd 

ispunct 0x21 - Ox2f Ox3a- 0x40 8 \ 
Ox5b - 0x60 0x7b - 0x7e 

iscntr] Ox0-Oxlf Ox/7f 

isblank 0x20 

isxdigit 0x30 - 0x39 0x61 - 0x66 = \ 
0x41 - 0x46 

ul <0x41 0x61> <0x42 0x62> <0x43 0x63> \ 
<0x44 0x64> <0x45 0x65> <0x46 0x66> \ 
<0x47 0x67> <0x48 0x68> <0x49 0x69> \ 
<0x4a Ox6a> <0x4b Ox6b> <0x4c Ox6c> \ 
<Ox4d Ox6d> <Oxde Ox6e> <Ox4f Ox6f> \ a 
<0x50 0x70> <0x51 0x71> <0x52 0x72> \ 
<0x53 0x73> <0x54 0x74> <0x55 0x75> = \ 
<0x56 0x76> <0x57 0x77> <0x58 0x78> \ 
<0x59 0x79> <0x5a 0x7a> 


cswidth 1:0,0:0,0:0 
LC_NUMERIC —num_ascii 
numer ic 


FILES 
/libflocale/locale/LC_CTYPE 
data file containing character classification and conversion tables 
created by chrtbl 


/lib/locale/locale/LC_NUMERIC 
data files containing numeric editing information 


/usr/include/ctype.h 
header file containing information used by character classification and a, 
conversion routines 
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SEE ALSO 
c™ ctype(3C), environ(5) in the Programmer’s Reference Manual 


DIAGNOSTICS 
The error messages produced by chrtbl are intended to be self-explanatory. They 
indicate errors in the command line or syntactic errors encountered within the 
input file. 
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NAME 
ckbupscd - check file system backup schedule 


SYNOPSIS 
/etc/ckbupscd [ -m ] 


DESCRIPTION 
The command ckbupscd consults the file /etc/bupsched and prints the file system 
lists from lines with date and time specifications matching the current time. If 
the -m flag is present an introductory message in the output is suppressed so that 
only the file system lists are printed. Entries in the /etc/bupsched file are printed 
under the control of cron. 


The System Administration commands bupsched/schedcheck are provided to 
review and edit the /etc/bupsched file. 


The file /etc/bupsched should contain lines of 4 or more fields, separated by 
spaces or tabs. The first 3 fields (the schedule fields) specify a range of dates 
and times. The rest of the fields constitute a list of names of file systems to be 
printed if ckbupscd is run at some time within the range given by the schedule 
fields. The general format is: 


time[,time] day[,day] month[,month] fsyslist 
where: 


time Specifies an hour of the day (0 through 23), matching any time within 
that hour, or an exact time of day (0:00 through 23:59). 


day Specifies a day of the week (sun through sat) or day of the month (1 
through 37). 


month Specifies the month in which the time and day fields are valid. Legal 
values are the month numbers (J through 72). 


fsyslist The rest of the line is taken to be a file system list to print. 


Multiple time, day, and month specifications may be separated by commas, in 
which case they are evaluated left to right. 


An asterisk (*) always matches the current value for that field. 
A line beginning with a sharp sign (#) is interpreted as a comment and ignored. 


The longest line allowed (including continuations) is 1024 characters. 
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EXAMPLES 
The following are examples of lines which could appear in the /etc/bupsched file. 
06:00-09:00 fri 1,2,3,4,5,6,7,8,9,10,11 /applic 
Prints the file system name /applic if ckbupscd is run between 6:00am 
and 9:00am any Friday during any month except December. 
00:00-06:00,16:00-23:59 1,2,3,4,5,6,7 1,8 / 
Prints a reminder to backup the root (/) file system if ckbupscd is run 


between the times of 4:00pm and 6:00am during the first week of 
August or January. 


FILES 
/etc/bupsched specification file containing times and file system to back up 


SEE ALSO 
cron(1M) 
echo(1) and sh(1) in the User’s Reference Manual 


BUGS 
ckbupscd reports file systems due for backup if invoked any time in the window. 
It does not know that backups may have just been taken. 
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NAME 


i clri - clear i-node 


SYNOPSIS 
/ete/clri special i-number .. 


DESCRIPTION 
The command c/n writes nulls on the 64 bytes at offset i-number from the start of 
the i-node list. This effectively eliminates the i-node at that address. Special is 
the device name on which a file system has been defined. After c/ri is executed, 
any blocks in the affected file show up as "not accounted for" when fsck(1M) is 
run against the file-system. The i-node may be allocated to a new file. 


Read and write permission is required on the specified special device. 


This command is used to remove a file which appears in no directory; that is, to 
get rid of a file which cannot be removed with the 7m command. 


SEE ALSO 
Mm» fsck(1M), fsdb(1M), ncheck(1M) 
fs(4) in the Programmer’s Reference Manual 
rm(1) in the User’s Reference Manual 


WARNINGS 
If the file is open for writing, cli does not work. The file system containing the 
file should be NOT mounted. 


If ciri is used on the i-node number of a file that does appear in a directory, it 1s 
imperative to remove the entry in the directory at once, since the i-node may be 
allocated to a new file. The old directory entry, if not removed, continues to 
point to the same file. This sounds like a link, but does not work like one. 
Removing the old entry destroys the new file. 
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NAME 
a» colltbl - generate a collation sequence table for a language 


SYNOPSIS 
colitbl [-r] file 


DESCRIPTION 
The colltbl command creates a binary version of the collation sequence table 
from the source definitions contained within file. The rules for the collation 
sequence specification are contained within file which is in user readable ASCII 
format. The colltbl utility takes the ASCII file and produces a binary file. The 
contents of file will allow the following attributes of the transformation definition: 


1-to-1 character mapping 
Where no transformation will take place on specified characters 


1-to-2 character mapping 
Where characters are treated as if they were two characters (e.g. the 
German B character becomes ss) 


c™ 2-to-1 character mapping 
Where certain character sequences represent a single character in the 
collating sequence (e.g., ch and // in Spanish, which are collated after e and 
l respectively) 


Don’t-care characters 
Where certain characters are ignored by the collating sequence. For 
example, if the dash character (-) were defined as a don’t-care character, 
the strings re-locate and relocate would be equal. 


Secondary weighting of characters 
Where a character does not have an identical sort value, even when that 
character is similar in symbolic shape. For example, the letters e and "e 
grave" in French will have the same primary weight, but a different 
secondary weight. 


file contains lines of text separated by a newline character. Each line must start 
with one of the following sequences: 


f™ 
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codeset codeset_name 


The codeset_name is the name of the file to be created by colltbl. This file 
will be created in binary format, so it will be unreadable on a terminal. 
Once created, it must be moved by hand to the directory relating to the 
locale of the language in question (i.e., /lib/locale/XX), and should be called 
LC_COLLATE within that directory. 


order is order list 


Page 2 


An order list is a list of symbols, separated by semicolons, that defines the 
collation sequence. 


The special symbol "...." provides a way to specify symbols that are lexically 
sequential in a short-hand form. For example: 


order is a;b;c;d;....%6);Z 


would specify the list of lowercase letters. Of course, this could be further 
compressed to just g}....;z. 


A symbol can be up to two bytes in length and can be represented in any 
one of the following ways: 


¢ the symbol itself (e.g., a for the lowercase letter a) 


e \x61 or 0x61 is the hexadecimal representation of the 
letter a 


Note that most ISO 8859/1 characters are defined in this way 
to ensure exactness of the collation table that is produced. 


e \141 or 0141 is the octal representation for the letter a 
e Any combination of these representations may be used. 


The backslash character (\) is used for continuation. No characters are 
permitted after the backslash character. For example: 


order is a;b;c;....;z;\\ 
L253;545 56,758,904) 3Z 


would create the collation table with both lines forming the one order rule. 


Symbols enclosed in parentheses are assigned the same primary weight but 
different secondary weights. Symbols enclosed in curly brackets are 
assigned only the same primary weight. For example: 


order is a;b;c;ch;d;(e;"e grave"),f.....;2;\\ 
th Ace 
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In the above example, e and "e grave" are assigned the same primary weight 
and different secondary weights. Digits 1 through 9 are assigned the same 
primary weights and no secondary weights. Only primary weights are 
assigned to the remaining symbols. Notice that double letters can be 
specified in the collating sequence (letter ch comes between c and d). 


substitute "regular_expression" with string 
A regular expression is an expression surrounded by double quotes that can 
be compiled by the regular expression compiler in regexp.h if the -r flag is 
specified in the command line. This allows 1-to-many and many-to-1 
mapping to be performed on characters or character sequences. If the -r 
flag is not used, the regular expression is simply treated as a regular C 
language string. The main use of this feature is to cater for the mapping of 
one character sequence to another, when one character sequence has the 
same meaning as another. 


For example: 
substitute "ss" with 245 


will replace the ss sequence with the character that is actually represented 
at code set position 245 octal. 


Comments may be included in file by placing a hash mark (#) in column one of 
the line. Empty lines and lines only containing space are ignored. 


EXAMPLES 
Example #1 


The following example will supply transformations for a simple English telephone 
book sorting sequence: 


# 

codeset telephone 

a 

# 

orderis A;a;B;b;C;c;D;d;E;e;F;f;G;2\ 
H;h;1;i;J;j;K;k;L;];M;m;N;n;O;0;P;p;Q;q\ 
R5r;S38;T;t;U3u;V3v;W3w;X5x; Y5y;Z5z 

# | 

a 

substitute "0" with "zero" 

substitute "1" with "one" 

substitute "2" with "two" 

substitute "3" with "three" 
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substitute "4" with "four" 
substitute "5" with "five" 
substitute "6" with "six" 
substitute "7" with "seven" 
substitute "8" with "eight" 
substitute "9" with "nine" 


Example #2 


In most cases, only primary weights are assigned to characters. Secondary weight 
ordering comes into effect only when a group of characters have the same 
primary weight. Examples are the letters e and "e grave" in French. The 
secondary weight is then used to break the tie. The assignment of weights to 
characters follows three rules; namely: 


¢ Don’t-care characters are always assigned a primary weight of 1. 


¢ Secondary weights are assigned from a pool of integers starting 
from two to the maximum number of symbols enclosed in parentheses, 
minus one. 


e Integers greater than the maximum secondary weight are used 
as primary weights. 


This example will illustrate the assignment of weights to characters: 
codeset fred 
order is (a;e;0;u;i);0;(1;....39);\\ 
A;B;C;CH;D,....;H;(1;J;K) 


This produces the following primary and secondary weight values: 


CHAR PRIMARY SECONDARY 
WEIGHT WEIGHT 

a ii Z 

e 11 3 

O 11 4 

u 17 5 

i 11 6 

0 12 

1 13 2 

2 13 3 

3 13 4 

4 13 5 

5 13 6 

6 GB 7 


Page 4 UP-14805 


COLLTBL (1M) 


B & 
‘© 00 


en 
< 


23 2 
23 7 
23 A 


When this collation sequence is applied to a string, it has the following 
transformation on output: 


c™ Input string: ae12jk 
Output string: 1411313 23.2523 25 


where the last four bytes of the output string are the secondary weight values. 


AS "“ZOAMNMOQAQDPOMONA 
bench 
CO 


DIAGNOSTICS 
The error messages produced by colltbl are intended to be self-explanatory. 
They indicate errors in the command line or syntactic errors encountered within 
the input file. 
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NAME 
config - configure a UNIX system 


SYNOPSIS 
config -s systemfile -c config dir 


DESCRIPTION 
The config command creates system data structures under the direction of the 
system file and module configuration files. The command language used in the 
system file and module configuration files is described in the Administration 
Guide. 


OPTIONS 
-s systemfile 
Name of the system file. 


-cconfig dir 
Path name of the configuration directory. 


FILES 
conf.c 
modlist 


SEE ALSO 
mkunix(1M) 


DIAGNOSTICS 
Diagnostics are displayed on standard output and are self-explanatory. 


SUPPORT STATUS 
Supported. 
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NAME 
cpset - install object files in binary directories 


SYNOPSIS 
cpset [-0] object directory [mode owner group] 


DESCRIPTION 
The command cpset is used to install the specified object file in the given 
directory. The -o forces cpset to move object to OLDobject in the destination 
directory before installing the new object. The mode, owner, and group, of the 
destination file may be specified on the command line. If this data is omitted, 
two results are possible: 


If the user of cpset has administrative permissions (that is, the user numerical ID 
is less than 100), the following defaults are provided: 

mode - 0755 

owner - bin 

group - bin 


If the user is not an administrator, the default mode, owner, and group of the 
destination file is that of the invoker. 


EXAMPLES 
cpset echo /bin 0755 bin bin 
cpset echo /bin 
cpset echo /bin/echo 


All the examples above have the same effect (assuming the user is an 
administrator). The file echo is copied into /bin and is given 0755, bin, and bin 
as the mode, owner, and group, respectively. 


FILE LOCATION CONTROL 
cpset uses the file /usr/sre/destinations to determine the final destination of a file. 
This locations file contains pairs of pathnames separated by spaces or tabs. The 
first name is the "official" destination (for example: /bin/echo). The second name 
is the new destination. For example, if echo is moved from /bin to /usr/bin, the 
entry in /usr/src/destinations would be: 


/bin/echo /usr/bin/echo 


When the actual installation occurs, cpset verifies that the "old" pathname does 
not exist. If a file exists at that location, cpset issues a warning and continues. 
This file does not exist on a distribution tape; it is used by sites to track local 
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command movement. The procedures used to build the source are responsible 
for defining the "official" locations of the source. 


CROSS GENERATION 
The environment variable ROOT is used to locate the destination file in the form 
$ROOT/usr/src/destinations. This is necessary in the cases where cross 
generation is being done on a production system. 


SEE ALSO 


install(1M) 
make(1) in the Programmer’s Reference Manual 
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NAME 


crash - examine system images 


SYNOPSIS 


fetc/crash [ -d dumpfile ] [ -n namelist ] [ -w outputfile ] 


DESCRIPTION 


The crash command is used to examine the system memory image of a live or a 
crashed system by formatting and printing control structures, tables, and other 
information. Command line arguments to crash are dumpfile, namelist, and 


outputfile. 
dumpfile is the file containing the system memory image. The default dumpfile is 
/dev/mem. 


The text file narmelist contains the symbol table information needed for symbolic 
access to the system memory image to be examined. The default namelist is /unix. 
If a system image from another machine is to be examined, the corresponding 
text file must be copied from that machine. 


When the crash command is invoked, a session is initiated. The output from a 
crash session is directed to outputfile. The default outputfile is the standard 
output. 


Input during a crash session is of the form: 
function [ argument ... | 


where function is one of the crash functions described in the "FUNCTIONS" 
section of this manual page, and arguments are qualifying data that indicate which 
items of the system image are to be printed. 


The default for process-related items is the current process for a running system 
and the process that was running at the time of the crash for a crashed system. If 
the contents of a table are being dumped, the default is all active table entries. 


The following function options are available to crash functions wherever they are 
semantically valid. 


-e Display every entry in a table. 
-f Display the full structure. 
-p Interpret all address arguments in the command line as physical addresses. 


-S process 
Specify a process slot other than the default. 
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-w file 
Redirect the output of a function to file. 


Note that if the -p option is used, all address and symbol arguments explicitly Ww 
entered on the command line are interpreted as physical addresses. If they are 
not physical addresses, results are inconsistent. 


The functions mode, defproc, and redirect correspond to the function options -p, 
-s, and -w. The mode function may be used to set the address translation mode 
to physical or virtual for all subsequently entered functions; defproc sets the value 
of the process slot argument for subsequent functions; and redirect redirects all 
subsequent output. 


Output from crash functions may be piped to another program in the following 
way: 


function [argument ... ]! shell_ command 
For example, 
mount ! grep rw 


writes all mount table entries with an mw flag to the standard output. The a 
redirection option (-w) cannot be used with this feature. 


Depending on the context of the function, numeric arguments are assumed to be 
in a specific radix. Counts are assumed to be decimal. Addresses are always 
hexadecimal. Table address arguments larger than the size of the function table 
are interpreted as hexadecimal addresses. Those smaller are assumed to be 
decimal slots in the table. Default bases on all arguments may be overridden. 
The C conventions for designating the bases of numbers are recognized. A 
number that is usually interpreted as decimal is interpreted as hexadecimal if it is 
preceded by @& and as octal if it is preceded by 0. Decimal override is 
designated by 0d, and binary by 0b. 


Aliases for functions may be any uniquely identifiable initial substring of the 
function name. Traditional aliases of one letter, such as p for proc, remain valid. 


Many functions accept different forms of entry for the same argument. Requests 
for table information accept a table entry number, a physical address, a virtual 
address, a symbol, a range, or an expression. A range of slot numbers may be | 
specified in the form a-b where a and b are decimal numbers. An expression Ww 
consists of two operands and an operator. An operand may be an address, a 

symbol, or a number; the operator may be +, -, *, /, &, or |. An operand which 

is a number should be preceded by a radix prefix if it is not a decimal number (0 

for octal, Ox for hexidecimal, 0b for binary). The expression must be enclosed in 
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parentheses (). Other functions accept any of these argument forms that are 
meaningful. 


Two abbreviated arguments to crash functions are used throughout. Both accept 
data entered in several forms. They may be expanded into the following: 


table_entry = table entry | address | symbol | range | expression 
start_addr = address | symbol } expression 


FUNCTIONS 
? [-w file ] 
List available functions. 


'cmd 
Escape to the shell to execute a command. 


adv [-e] [-w file] [[-p]table entry... ] 
Print the advertise table. 


base [ -w file ] number ... 
Print number in binary, octal, decimal, and hexadecimal. A number in a 
radix other than decimal should be preceded by a prefix that indicates its 
radix as follows: Qx, hexidecimal; 0, octal; and 0b, binary. 


buffer [ -w file] [-format] bufferslot 
or 


buffer [-w file] [-format] [-p]start_addr 
Alias: b. 
Print the contents of a buffer in the designated format. The following 
format designations are recognized: -b, byte: -c, character; -d, decimal; -x, 
hexadecimal; -o, octal; -r, directory; and -i, inode. If no format is given, the 
previous format is used. The default format at the beginning of a crash 
session is hexadecimal. 


bufhdr [-f] [-w file] [[-p]table_entry...] 
Alias: buf. 
Print system buffer headers. 


callout [ -w file ] 
Alias: c. 
Print the callout table. 
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dballoc [ -w file] [class ... ] 
Print the dballoc table. If a class is entered, only data block allocation | 
information for that class is printed. a, 


dbfree [-w file] [class ... ] 
Print free streams data block headers. If a class is entered, only data block 
headers for the class specified are reprinted. 


dblock [-e] [-w file] [-c class... ] 
or 


dblock [-e] [-w file] [[-p] table entry... ] 
Print allocated streams data block headers. If the class option (-c) is used, 
only data block headers for the class specified are printed. 


defproc [ -w file] [-c] 
or 


defproc [ -w file] [slot] 
" Set the value of the process slot argument. The process slot argument may | 
be set to the current slot number (-c) or the slot number may be specified. , 
If no argument is entered, the value of the previously set slot number is 
printed. At the start of a crash session, the process slot is set to the current 
process. 


dis [-w file] [-a] start_addr [ count ] 
Disassemble from the start address for count instructions. The default count 
is 1. 

ds [ -w file] virtual_address ... 


Print the data symbol whose address is closest to, but not greater than, the 
address entered. 


file [-e] [-w file] [[-p]table entry... ] 
Alias: f. 
Print the file table. 


findaddr [ -w file] table slot 
Print the address of s/ot in table. Only tables available to the size function : 
are available to findaddr. J 


findslot [ -w file ] virtual_ address ... 
Print the table, entry slot number, and offset for the address entered. Only 
tables available to the size function are available to findslot. 


—_— 
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fs [-w file] [[-p]table_ entry... ] 
Print the file system information table. 


gdp [-e] [-f] [-w file] [[-p]table_entry... ] 
Print the gift descriptor protocol table. 


help [ -w file] function ... 
Print a description of the named function, including syntax and aliases. 


inode [-e] [-f] [-w file] [[-p]table_entry... ] 
Alias: i. 3 
Print the inode table, including file system switch information. 


Ick [-e] [-w file] [[-p]table entry... ] 
las: I. 
Print record locking information. If the -e option is used or table address 
arguments are given, the record lock list is printed. If no argument is 
entered, information on locks relative to inodes is printed. 


linkblk [ -e] [-w file] [[-p]table_entry... ] 
Print the linkblk table. 


map [ -w file ] mapname ... 
Print the map structure of the given mapname. 


mbfree | -w file ] 
Print free streams message block headers. 


mblock [-e] [-w filename] [[-p]table_entry...] 
Print allocated streams message block headers. 


mode [ -w file] [mode ] 
Set address translation of arguments to virtual (v) or physical (p) mode. If 
no mode argument is given, the current mode is printed. At the start of a 
crash session, the mode is virtual. 


mount [-e] [-w file] [[-p]table_ entry... ] 
Alias: m. 
Print the mount table. 


nm [ -w file] symbol ... 
Print value and type for the given symbol. 


od [-p] [-w file] [-format] [-mode] [-s process ] 
start_addr [ count | 
Alias: rd. 
Print count values starting at the start address in one of the following 
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formats: character (-c), decimal (-d), hexadecimal (-x), octal (-0), ascii (-a), 

or hexadecimal/character (-h), and one of the following modes: long (-l), 

short (-t), or byte (-b). The default mode for character and ascii formats is WwW 
byte; the default mode for decimal, hexadecimal, and octal formats is long. 

The format -h prints both hexadecimal and character representations of the 
addresses dumped; no mode needs to be specified. When format or mode 

is omitted, the previous value is used. At the start of a crash session, the 

format is hexadecimal and the mode is long. If no count is entered, 1 is 

assumed. 


peb [-w file] [-u] [ process ] 
or 

peb [ -w file] [-k] [ process ] 
or 

pdt [-e] [-w file] [-s process] section segment 
or 


pdt [-e] [-w file] [-s process] [-p] start_addr [ count ] A 
The page descriptor table of the designated memory section and segment is 
printed. Alternatively, the page descriptor table starting at the start address 
for count entries is printed. If no count is entered, 1 is assumed. 


pfdat [-e] [-w file] [[-p]table_entry...] 
Print the pfdata table. 


proc [-f] [-w file] [[-p] table_entry ... #procid ...] 
or 


proc [-f] [-w file] [-r] 
Alias: p. 
Print the process table. Process table information may be specified in two 
ways. First, any mixture of table entries and process IDs may be entered. 
Each process ID must be preceded by a #. Alternatively, process table 
information for runnable processes may be specified with the runnable 


option (-r). | | 
qrun [ -w file ] 

Print the list of scheduled streams queues. 
queue [-e] [-w file] [[-p]table_entry...] 

Print streams queues. 
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quit Alias: q. 
Terminate the crash session. 


revd [-e] [-f] [-w file] [[-p]table_entry...] 
Print the receive descriptor table. 


redirect [ -w file] [-c] 
or 


redirect [ -w file] [file ] 
Used with a file name, redirects output of a crash session to the named file. 
If no argument is given, the file name to which output is being redirected is 
printed. Alternatively, the close option (-c) closes the previously set file 
and redirects output to the standard output. 


region [-e] [-f] [-w file] [[-p]table_entry... ] 
Print the region table. 


sdt [-e] [-w file] [-s process] section 


The segment descriptor table for the named memory section is 
printed. 


search [-p] [-w file] [-m mask] [-s process | 
pattern 
start_addr length 
Print the words in memory that match pattem, beginning at the start address 
for length words. The mask is anded (&) with each memory word and the 
result compared against the pattern. The mask defaults to Oxfffffff. 


size [ -w file] [-x] [structure_name ... ] 
Print the size of the designated structure. The (-x) option prints the size in 
hexadecimal. If no argument is given, a list of the structure names for 
which sizes are available is printed. 


sndd [-e] [-w file] [[-p]table_entry...] 
Print the send descriptor table. 


srmount [-e] [-w file] [[-p]table entry... ] 
Print the server mount table. 


stat [ -w file ] 
Print system statistics. 


stream [-e] [-f] [-w file] [[-p]table_entry...] 
Print the streams table. 
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strstat [ -w file ] 
Print streams statistics. 


ts [-w file] virtual_address ... 
Print closest text symbol to the designated address. 


tty [-e] [-f] [-w file] [-ttype[[-p]table_entry...]] 
or 


tty [-e] [-f] [-w file] [[-p]start_addr] 
Valid types: con, getty. 
Print the tty table. If no arguments are given, the tty table for the getty type 
is printed. If the -t option is used, the table for the single tty type specified 
is printed. If no argument follows the type option, all entries in the table 
are printed. A single tty entry may be specified from the start address. 


user [-f] [-w file] [ process ] 
Alias: u. 
Print the ublock for the designated process. 


var [ -w file 
Alias: v. 
Print the tunable system parameters. 


FILES 
/dev/mem system image of currently running system 
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NAME 
c™ cron - clock daemon 


SYNOPSIS 
/etc/cron 


DESCRIPTION 
The command cron executes commands at specified dates and times. Regularly 
scheduled commands can be specified according to instructions found in crontab 
files in the directory /usr/spool/cron/crontabs. Users can submit their own 
crontab file using the crontab(1) command. Commands which are to be executed 
only once may be submitted using the at(1) command. 


cron only examines crontab files and at command files during process 
initialization and when a file changes by means of crontab or at. This reduces the 
overhead of checking for new or changed files at regularly scheduled intervals. 


Since cron never exits, it should be executed only once. This is done routinely 
through /etc/re2.d/S75cron at system boot time. /usr/lib/cron/FIFO is used as a 
c™ lock file to prevent the execution of more than one cron. 


If time changes are made, bring the system down to single-user mode and then 
back up to multi-user mode to ensure that cron executes correctly. 


FILES 
/usr/lib/cron main cron directory 
/usr/lib/cron/FIFO 
used as a lock file 
/usr/lib/cron/log accounting information 
/usr/spool/cron — spool area 


SEE ALSO 
at(1), crontab(1), sh(1) in the User’s Reference Manual 


DIAGNOSTICS 
A history of all actions taken by cron are recorded in /usr/lib/cron/log. 
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NAME 
cc” dcopy - copy file systems for optimal access time 


SYNOPSIS 
/etc/dcopy [-sX] [-an] [-d] [-v] [-ffsize[:isize]] inputfs outputfs 


DESCRIPTION 
The command dcopy copies file system inputfs to outputfs. inputfs is the device 
file for the existing file system; outputfs is the device file to hold the reorganized 
result. For the most effective optimization inputfs should be the raw device and 
outputfs should be the block device. Both inputfs and outputfs should be 
unmounted file systems (in the case of the root file system, the copy must be to a 
new pack). 


With no options, dcopy copies files from inputfs compressing directories by 
removing vacant entries, and spacing consecutive blocks in a file by the optimal 
rotational gap. The possible options are 


-sX supply device information for creating an optimal organization of 
blocks in a file. The forms of X are the same as the -s option of 
, fsck(1M). 
-an place the files not accessed inn days after the free blocks of the 


destination file system (default for n is 7). If non is specified then 
no movement occurs. 


-d leave order of directory entries as is (default is to move sub- 
directories to the beginning of directories). 


-V currently reports how many files were processed, and how big the 
source and destination freelists are. 

-ffsize [sisize | 
specify the outputfs file system and inode list sizes (in blocks). If the 
option (or :isize) is not given, the values from the inputfs are used. 


dcopy catches interrupts and quits, and reports on its progress. To terminate 
dcopy send a quit signal, followed by an interrupt or quit. 


© SEE ALSO 


fsck(1M), mkfs(1M) 
ps(1) in the User’s Reference Manual 
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NAME 
devnm - device name 


SYNOPSIS 
/etc/devnm [names ] 


DESCRIPTION 
The command devnm identifies the special file associated with the mounted file 
system where the argument name resides. 


This command is most commonly used by /etc/bre [see brc(1M)] to construct a 
mount table entry for the root device. 


EXAMPLES 
The command: 
/etc/devnm /usr 
produces 
/dev/dsk/c1d0s2 usr 
if /usr is mounted on /dev/dsk/cld0s2. 


FILES 
/dev/dsk/* 
/etc/mnttab 


SEE ALSO 
brc(1M) 
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NAME 
_ df - report number of free disk blocks and i-nodes 


SYNOPSIS 
df [-It] [-f] [ file-system | directory | mounted-resource |] 


DESCRIPTION 
The command df prints out the number of free blocks and free i-nodes in 
mounted file systems, directories, or mounted resources by examining the counts 
kept in the super-blocks. 


file-system may be specified either by device name (e.g. /dev/dsk/cld0s2) or by 
mount point directory name (e.g. /usr). 


directory can be a directory name. The report presents information for the device 
that contains the directory. 


mounted-resource can be a remote resource name. The report presents 
information for the remote device that contains the resource. 


If no arguments are used, the free space on all locally and remotely mounted file 
systems is printed. 


OPTIONS 
-|_ _—_— only reports on local file systems. 


-t causes the figures for total allocated blocks and i-nodes to be reported as 
well as the free blocks and i-nodes. 


-f an actual count of the blocks in the free list is made, rather than taking the 
figure from the super-block (free i-nodes are not reported). This option 
does not print any information about mounted remote resources. 


NOTES 
If multiple remote resources are listed that reside on the same file system on a 
remote machine, each listing after the first one is marked with an asterisk. 


FILES 
/dev/dsk/* 
/etc/mnttab 


SEE ALSO 
fs(4), mnttab(4), mount(1M) 
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NAME 
di - diskinfo utility 


SYNOPSIS 
di [[-s]{q ¢d]] [-d disk [-[slmb][pfte/ds}] [-ffile] 


DESCRIPTION 
di manages the disk database file /usr/lib/diin or a user supplied file in diskinfo 
format. The file holds information (parameters) necessary to enable the disk 
drivers and formatters to properly handle the disk drives. These parameters are 
used to create the bootblock on the drives and can only be run by superuser. 


FORMAT 
In the following diskinfo file format ; denotes field separators, | separates within 
the name field, and , separates parameters. A nonCOMMENT, nonwhite 
character in the first position denotes the beginning of an entry. 


bootblock name}|mnemonic name} full name,parameters, 
An entry can exist on more than one line when continued with white space in the 


first position. If the parameter is boolean, existence denotes true. If the 
parameter has a value, par= value is used. 


Print formats: 
short full name mnemonic name 
long boot block name} mnemonic name! full name,parameters, 


Error Codes (exit statuses): 


EOK exit ok 

EUS error in usage 

EOP error in open 

ERD error in read 

ECR error in create (write) 
ENE disk name does not exist 
EOS caught signal and exiting 


EUN unknown error 
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OPTIONS 
Only one valid option at a time may be used (not including -f file). 


Options for all disks: 


-S print all entries (short format) 
-] print all entries (long format) 
-q id query -- print mnemonic of all disks with id 


Options for one disk: 


-d disk for specified disk where disk matches the mnemonic name 
or boot name 


Options for user provided file: 
-f file user supplied diskinfo formatted file 


NOTE: The following options use a disk specified by -d. 


-S print entry for specified disk (short format) 
| print entry for specified disk (long format) 
-m search for disk; print mnemonic name 
-b search for disk; print boot block name 


-p fields __ print fields associated with disk fields is of the form 
field1,field2,... where fieldx matches a disk parameter 
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NAME 
diskusg - generate disk accounting data by user ID 


SYNOPSIS 
diskusg [options] [files] 


DESCRIPTION 
The command diskusg generates intermediate disk accounting information from 
data in files, or the standard input if omitted. diskusg outputs lines on the 
standard output, one per user, in the following format: uid login #blocks 


where 

uid is the numerical user ID of the user. 

login is the login name of the user. 

#blocks is the total number of disk blocks allocated to this user. 


diskusg normally reads only the inodes of file systems for disk accounting. In this 
case, files are the special filenames of these devices. 


rr" diskusg recognizes the following options: 


-S means that the input data is already in diskusg output format. 
diskusg combines all lines for a single user into a single line. 


-V signifies verbose. Print a list on standard error of all files that are 
charged to no one. 


-i fnmiist means to ignore the data on those file systems whose file system 
name is in fnmiist. fnmlist is a list of file system names separated by 
commas or enclosed within quotes. diskusg compares each name 
in this list with the file system name stored in the volume ID [see 
labelit(1M)]. 


-p file means to use file as the name of the password file to generate login 
names. /etc/passwd is used by default. 


-u file means to write records to file of files that are charged to no one. 
Records consist of the special filename, the inode number, and the 


‘™ user ID. 


The output of diskusg is normally the input to acctdisk [see acct(1M)] which 
generates total accounting records that can be merged with other accounting 
records. diskusg is normally run in dodisk [see acctsh(1M)]. 


DISKUSG(1M) 


EXAMPLES 
The following generates daily disk accounting information for root on 
/dev/dsk/c1d0s0: 


diskusg /dev/dsk/c1d0s0 | acctdisk > disktacct 


FILES 
/etc/passwd used for user ID to login name conversions 


SEE ALSO 
acct(1M), acctsh(1M) 
acct(4) in the Programmer’s Reference Manual 
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dkpart - set/calculate hard disk partition sizes 


SYNOPSIS 


/etc/dkpart [-p|-P] [-d] disk-name 


DESCRIPTION 
The command dkpart sets hard disk partition sizes. The disk partition sizes are 
based on the total amount of usable space on the hard disk. Usable space is the 
total capacity of the disk minus the space reserved for the badblock table, 
maintenance cylinder, and other space taken by the disk subsystem overhead. 


There are sixteen partitions available to describe the disk space and to divide its 
capacity. Partition 0 is, by convention, used to access the entire physical disk, 
including the reserved space. In normal operation, partition 0 is not used and is 
not accessible using the -p option. Partition 15 is reserved as the swap partition 
on the swap device. The swap partition is variable in size and may occupy any of 
the usable space on the disk. The other fourteen partitions are variable in size 
occupying whatever space the user desires. 


OPTIONS 
-p or -P 


-d 
disk-name 


CAUTION 


Read a table of the form (size offset) from standard input or from 
the diskinfo file. The option assumes the table supplied is correct; no 
input checking is performed other than checking and enforcing 
cylinder boundaries. This differs slightly from format(1M) which 
forces track boundaries in partition sizes. The -P version of the 
option causes dkpart to keep a total of the offsets in the -P options. 
This is useful when the desired size of partitions is known, but the 
exact offsets are not. The utility sets the offsets and fills any zero size 
partitions with the remaining space. 

Display the disk partition table on standard output. 


The character special name or generic type and position (for 
example, h501, h502, h801). 


Some utilities use partitions 13 and 14 during the process. It is advisable to not 
use these partitions as a part of normal disk operation. 


EXAMPLES 


The following input file sets up partitions 0 through 15. The file system (partition 
1) has a size of 224910 512-byte blocks and an offset of 0. The swap space 
(partition 15) has a size of 8160 512-byte blocks and an offset of 224910. 
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234090 0 
224910 0 


8160 224910 


The following example shows reading the disk partition sizes for h501 into 
filename and then using the contents of filename to set the disk partition sizes for 
h502. 


dkpart -d hS01 > filename 
_dkpart -p h502 < filename 


The following example shows reading the disk partition sizes for h502 from the 
encrypted system default diskinfo file. . 


dkpart -p h502 


SEE ALSO 
format(1M) 


RESTRICTIONS 
dkpart permanently changes the partition table for unmounted filesystems only. If 
dkpart is performed on a mounted filesystem, the partition table appears to be 
updated. However, after rebooting the system, the partition table reverts back to 
the original configuration. dkpart does not permanently save the updated 
partition table for mounted filesystems. 


Format(1M) and dkpart(1M) can not simultaneously be performed on the system. 
dkpart is not supported for 5.25 inch floppy or 3 inch removable disks. 
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NAME 
dname - Print Remote File Sharing domain and network names 


SYNOPSIS 
dname [-D domain] [-N netspec] [-dna] 


DESCRIPTION 
The command dname prints or defines a host’s Remote File Sharing domain 
name or the network used by Remote File Sharing as transport provider. When 
used with d, n, or a options, dname can be run by any user to print the domain 
name, network name or both, respectively. Only a user with root permission can 
use the -D domain option to set the domain name for the host or -N netspec to 
set the network specification used for Remote File Sharing. (The value of 
netspec is the network device name, relative to the /dev directory. 


domain must consist of no more than 14 characters, consisting of any 
combination of letters (uppercase and lowercase), digits, hyphens (-), and 
underscores (_) 


When dname is used to change a domain name, the host’s password is removed. 
The administrator is prompted for a new password the next time Remote File 
Sharing is started [rfstart(1M)]. 


If dname is used with no options, it defaults to dname -d. 


ERRORS 
You cannot use the -N or -D options while Remote File Sharing is running. 


SEE ALSO 
rfstart(1M) 
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NAME 


SYNOPSIS 


dpasswd - create/remove dialup passwords and login shells 


/etc/dpasswd [-u userlist] [-s shell] [-r userlist] [-x shell] [-f] [-a term-list] 
[-d term-list] 


DESCRIPTION 
The command dpasswd creates login shells to be associated with specific users 
and dialup passwords for these shells. dpasswd removes dialup passwords for a 
specified shell and removes the shell file if requested. dpasswd can restore a 
user’s login shell back to /bin/sh and remove the old shell if requested. The -a 
and the -d options identify which lines require dialup passwords. 


OPTIONS 


-u userlist 


-s shell 


causes a new shell to be created for the user names in the userlist. 
Userlist is a list of user names separated by either commas or white 
space and the entire list enclosed in quotes. The new shell is simply 
linked to the old shell as well as being changed in the /etc/passwd file. 
An entry is put into the /etc/d_passwd file for this shell. If no other 
users are assigned this shell, the password is effectively just for the user. 
If the -s option is not used to specify the shell filename, dpasswd creates 
a new shell file by taking the current shell filename and appending a 
unique set of six characters to it and then linking the new shell file to 
your old shell. 


causes an entry to be put in the /etc/d_passwd file. If there is already a 
password with this particular shell, the old record is removed and 
replaced. If used with the -u option, the specified shell becomes the 
login shell for all the users listed in userlist. 


-r userlist 


-x shell 


-f 


UP-14805 


changes the user’s login shell to /bin/sh for every user listed in userlist. 
If the user had a unique shell, the entry for the unique shell is removed 
from the /etc/d_passwd file. 


causes the specified shell and its associated password to be removed 
from the /etc/d_passwd file. 


forces removal of shells under the /bin directory that are no longer 
shells for any user when used with the -u option. If the -f option is not 
specified, the superuser is queried if the shell should be removed. 


Page 1 


DPASSWD (iM) 
Se ig et 


-a term-list 
_ The terminals listed are added to the /etc/dialups file. When a user logs 

into the system from one of the listed terminals and has a shell defined 
in /etc/d_passwd, the user must supply the matching password. 
Terminal _list is either a list of terminals separated by commas, or a list 
of terminals separated by white space and the entire list enclosed with a 
single pair of quotes. 

-d term-list 
The terminals listed are removed from the /etc/dialups file. Therefore, 
no dialup password is required when a user logs in from one of the 
listed terminals. Validation of the terminals listed is not performed. 
Invalid terminals are skipped with no diagnostic messages. 


FILES 
/etc/d_passwd 
/etc/dialups 
/etc/passwd 


SEE ALSO 
login(1) in the User’s Reference Manual 


crypt(3C), passwd(4), dialups(4), d_passwd(4) in the Programmer’s Reference 
Manual 


RESTRICTIONS 
A dialup password can not be assigned to the system console device. 


The shell name can not exceed 25 characters. 
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NAME 
™ du, dulk, du4k - summarize disk usage 


SYNOPSIS 
du [ -ars | [ names | 
dulk [ -ars ] [ names |] 
du4k [ -ars ] [ names | 

DESCRIPTION 
The du, dulk, and du4k commands print the number of 512-byte blocks, 1024- 
byte blocks, and 4096-byte blocks, respectively, which are contained in all files 
and directories within each directory and file specified by the names argument. 
The number of blocks includes the indirect blocks of the file. If narnes 1s 
missing, the . is used. If no options are given, du generates an entry for each 


directory only, and generates no messages about directories that cannot be read, 
files that cannot be opened, etc. 


Mm A file with more than one link is only counted once. 


OPTIONS 
-s___ Prints only the grand total for each of the specified names. 


-a Generates and prints an entry for each file. 


-r___ Prints messages about directories that cannot be read, files that cannot be 
opened, etc. 


RESTRICTIONS 
If the -a option is not used, non-directories given as arguments are not listed. 


If there are too many distinct linked files, du counts the excess files more than 
once. 


Files with holes in them get an incorrect block count. 
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NAME 
rr errdead - extract error records from dump 


SYNOPSIS 
/etc/errdead dumpfile [ namelist ] 


DESCRIPTION 
When errors are detected by the system, an error record that contains 
information pertinent to the error is generated. If the error-logging daemon 
errdemon(1M) is not active or if the system crashes before the record can be 
placed in the error file, the error information is held by the system in a local 
buffer. 


errdead examines a system memory, extracts such error records, and passes them 
to errpt(1M) for analysis. 


The dumpfile specifies the memory that is to be examined (1.e. /dev/kmem). 


The system namelist is specified by namelist; if not given, /unix is used. 


( \  FIEs 


/dev/kmem system memory 
/unix system namelist 
/usr/bin/errpt analysis program 
/usr/tmp/errXxXXXXX_ temporary file 
DIAGNOSTICS 
Diagnostics may come from either errdead or errpt. In either case, they are self- 
explanatory. 
SEE ALSO 


errdemon(1M), errpt(1M) 
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NAME 
errdemon - error-logging daemon 


SYNOPSIS 
/usr/lib/errdemon [ file ] 


DESCRIPTION 
The error logging daemon evrdemon collects error records from the operating 
system by reading the special file /dev/error and places them in file. If file is not 
specified when the daemon is activated, /usr/adm/errfile is used. Note that file is 
created if it does not exist; otherwise, error records are appended to it, so that no 
previous error data is lost. 


No analysis of the error records is done by errdernon; that responsibility is left to 
errpt(1M). 

The error-logging daemon is terminated by sending it a software kill signal [see 
kill(1)}. 


Only the superuser may start the daemon. Only one daemon may be active at 
any time. 


FILES 
/dev/error source of error records 
/ust/adm/errfile repository for error records 


DIAGNOSTICS 
The diagnostics produced by errdemon are self-explanatory. 


SEE ALSO 


errpt(1M), errstop(1M), err(7) 
kill(1) in the User’s Reference Manual 
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NAME 
errpt - process a report of logged errors 


SYNOPSIS 
errpt [ options ] [ files | 


DESCRIPTION 
The command errpt processes data collected by the error logging mechanism 
[errdemon(1M)] and generates a report of that data. The default report is a 
summary of all errors posted in the files named. Options apply to all files and 
are described below. If no files are specified, evrpt attempts to use 
/usr/adm/errfile as file. 


A summary report notes the options that may limit its completeness, records the 
time stamped on the earliest and latest errors encountered, and gives the total 
number of errors of one or more types. 


Each device summary contains the total number of unrecovered errors, recovered 
errors, errors unable to be logged, I/O operations on the device, and 
miscellaneous activities that occurred on the device. 


The number of times that errpt has difficulty reading input data is included as 
read errors. 


Any detailed report contains, in addition to specific error information, all 
instances of the error logging process being started and stopped, and any time 
changes [using date(1)] that took place during the interval being processed. 


A summary of each error type included in the report is appended to a detailed 
report. 


OPTIONS 
A report may be limited to certain records in the following ways: 


-s date 
Ignore all records posted earlier than date, where date has the form 
mmddhhmmyy, consistent in meaning with the date(1) command. 


-e date 
Ignore all records posted later than date, whose form is as described above. 


Produce a detailed report that includes all error types. 
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-d deviist 
Limit a detailed report to data about devices given in deviist, where deviist 
can be one of two forms: a list of device identifiers separated from one 
another by a comma, or a list of device identifiers enclosed in double 
quotes and separated from one another by a comma and/or more spaces. 
errpt is familiar with the common form of identifiers, for example, h501. The 
devices for which errors are logged are: 


h501, 502 

£501, £502 

st01, st02 

h801, h802, h803, h804 
pt0a, pt0b 

tt0O - ttxx (xx = maximum port defined) 
pp00 - pp05 

et00 

hd00 - hd03 

bt00 - bt03 

sd01 - sd64 

ss31 - ss61 


Additional identifiers are int and mem which include detailed reports of 
stray-interrupt and memory-parity type errors respectively. 


-p n 
Limit the size of a detailed report to n pages. 
-f 
In a detailed report, limit the reporting of block device errors to 
unrecovered errors. 
FILES 
/usr/adm/errfile default error file 
SEE ALSO 
errdemon(1M) 


errfile(4) in the Programmer’s Reference Manual 
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NAME 
ft’ errstop - terminate the error-logging daemon 


SYNOPSIS 
/etc/errstop [ namelist ] 


DESCRIPTION 
The command errstop terminates the error-logging daemon, errdemon(1M), by 
executing ps(1) to determine the identity of the daemon and then sending it a 
software kill signal [see signal(2)]. 


The /unix file is used as the system namelist if none is specified. 


Only the superuser may use ev7stop. 


FILES 
/unix default system namelist 


DIAGNOSTICS 
m» The diagnostics produced by evrstop are self-explanatory. 


SEE ALSO 
| errdemon(1M) 
| ps(1) in the User’s Reference Manual 
kill(2), signal(2) in the Programmer’s Reference Manual 
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NAME 
o™ ff - list file names and statistics for a file system 


SYNOPSIS 
/ete/ff [options] special 


DESCRIPTION 
The command ff reads the i-list and directories of the special file, assuming it is a 
file system. I-node data is saved for files which match the selection criteria. 
Output consists of the pathname for each saved i-node, plus other file 
information requested using the print options below. Output fields are positional. 
The output is produced in i-node order; fields are separated by tabs. The default 
line produced by ff is: 


path-name i-number 
With all options enabled, output fields would be: 


path-name i-number size uid 


m» The argument n in the option descriptions that follow is used as a decimal integer | 
| } (optionally signed), where +n means more than n, -n means less thann, and n | 
means exactlyn. A day is defined as a 24 hour period. | 
-I Do not print the i-node number after each pathname. 
- Generate a supplementary list of all pathnames for multiply- 
linked files. 
-p prefix _ The specified prefix is added to each generated pathname. The | 
default is . (dot). 
-S Print the file size, in bytes, after each pathname. | 
-U Print the owner’s login name after each pathname. | 
“an Select if the i-node has been accessed inn days. 
-m 1 Select if the i-node has been modified inn days. | 
“cn Select if the i-node has been changed inn days. 
( : -n file Select if the i-node has been modified more recently than the | 
argument file. | 


-i i-node-list | Generate names for only those i-nodes specified in i-node-lst. 
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SEE ALSO 
ncheck(1M) 
find(1) in the User’s Reference Manual 


BUGS 
If the -I option is not specified, only a single pathname out of all possible ones is 
generated for a multiply-linked i-node. If -1 is specified, all possible names for 
every linked file on the file system are included in the output. However, no 
selection criteria apply to the names generated. 
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NAME 
filesave, tapesave - daily/weekly UNIX system file system backup 


SYNOPSIS 
/etc/filesave.? 
/etc/tapesave 


DESCRIPTION 
The scripts filesave and tapesave are provided as model shell scripts. They are 
designed to provide a simple, interactive operator environment for file backup. 
filesave.? is for daily disk-to-disk backup and tapesave is for weekly disk-to-tape. 


The suffix .? can be used to name another system where two (or more) machines 
share disk drives (or tape drives) and one or the other of the systems is used to 
perform backup on both. 


SEE ALSO 
shutdown(1M), volcopy(1M) 
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NAME 


finc - fast incremental backup 


SYNOPSIS 


/etc/finc [selection-criteria] file-system raw-tape 


DESCRIPTION 


finc selectively copies the input file-system to the output raw-tape. To be cautious, 
mount the input file-system read-only to insure an accurate backup, although 
acceptable results can be obtained in read-write mode. The tape must be 
previously labelled by /abelit. The selection is controlled by the selection-critena, 
accepting only those inodes/files for whom the conditions are true. 


It is recommended that production of a finc tape be preceded by the ff command, 
and the output of ff be saved as an index of the tape’s contents. Files on a finc 
tape may be recovered with the frec command. 


The argument 7 in the selection-criteria which follow is used as a decimal integer 
(optionally signed), where +n means more than, -n means less thann, andn 
means exactlyn. A day is defined as a 24 hours. 


-an True if the file has been accessed inn days. 
-mn True if the file has been modified inn days. 
“Cn True if the i-node has been changed in n days. 
-n file True for any file which has been modified more recently than 
the argument file. 
EXAMPLES 


To write a tape consisting of all files from file-system /usr modified in the last 48 
hours: 


finc -m -2 /dev/rdsk/c1d0s2 /dev/rmt/cOd0v 


SEE ALSO 


ff{(1M), frec(1M), labelit(1M) 
cpio(1) in the User’s Reference Manual 
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NAME 
findroot - find root device name 


SYNOPSIS 
/etc/findroot 


DESCRIPTION 
The command findroot identifies the device name where the root file system (/) 
resides. The device name is a special file located in /dev. 


FILES 
/etc/devnm 


SEE ALSO 
devnm(1M) 
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NAME 
» format - formatter for the 5.25 and 8 inch disks 


SYNOPSIS 
/etc/format -d device [-s] [-c n] [-is] filename] [-usb [filename] ] [-maint] 


DESCRIPTION 
The /etc/format command is used to format 5.25 and 8 inch Winchester disks and 
floppy disks. Invoking /etc/format with no options produces a help line giving a 
syntax description with all option groups listed. 


The formatter runs six distinct phases: 


Determine Disk Type Phase 

The first phase of the formatter determines the disk type to be formatted. 
If the boot block is valid, the drive is formatted. If the boot block is not 
valid, the formatter determines the number of tracks per cylinder (i.e. 
heads) of the drive by formatting the first cylinder. Once the number of 
heads is determined, all drives with the same number of heads are 

f~ displayed to the screen so that the user may select the drive type from the 

, list. Specification of the -maint option inhibits determining the number of 

heads. 


If the -maint option is specified and the bootblock is invalid, the formatter 
attempts to locate a valid copy of the bootblock at the end of the disk (see 
Boot Block Phase below). If a valid copy is not located, an error message 
is displayed and the disk must be reformatted. 


Format Phase 
The second phase formats the entire disk or a partition if specified. 
Specification of the -maint option inhibits this phase. 


Certification Phase 
The third phase is the certification phase. The -c option specifies the 
number of certification passes. The default is -c 0 for floppy disk, -c 1 for 
Winchester 8 inch disks, and -c 4 for Winchester 5.25 inch disks. 


Specification of the -maint option inhibits this phase. 


Cy 


Reformat Phase 
The fourth phase is the reformat phase which applies only to Winchester 
disks. In this phase blocks found bad during certification or specified as bad 
in the usb input are relocated to the maintenance area of the disk 
(approximately last 4 cylinders), and the track is reformatted. Data in good 
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blocks on that track is saved and rewritten. The reformat phase does not 
relocate bad blocks in the maintenance area; however, they are marked as 
bad. The bad block table and alternate block area of the disk can hold up 
to 512 alternates. /etc/format writes the table to the disk at the end of the 
reformat phase. 


The -usb option indicates that user supplied media defect information is to 
be taken from file (if specified) or from standard input; see INPUT DATA 
below. 


Loader Phase 
The fifth phase writes the Intermediate System Loader (ISL) to the disk 
into the maintenance area. For floppy disks the maintenance aréa uses only 
the last two cylinders. An ISL must be on the disk in order to boot from the 
disk. The filename specified must be /sys/boot/is] unless the user supplies 
an ISL loader. The ISL, /sys/boot/isl, is always written to the disk unless 
the -is] option is used to specify a different ISL. 


Specification of the -maint option inhibits this phase. 


Boot Block Phase 
The final phase writes a bootblock into the first block of the device and to 
the first block on the last three cylinders. A bootblock must be on the disk 
in order to boot from the disk. 


OPTIONS 
The options may be specified in any order. The -d option is the only required 
option. 


-d device 
Use device as the name of the disk to be formatted; device is the character 
special device representing a partition of the device (e.g. /dev/rdsk/0s0 for 
first 5.25 inch Winchester disk, partition 0 ). 


-s_ Do not operate in verbose mode. /etc/format displays phase messages and 
bad block information to the screen in verbose mode. It is recommended 
that verbose mode be used for all invocations of the formatter. 


-cn Usen as the number of certification passes to perform. 


-is] filename 
Write an ISL to the disk from the file specified by filename. The default 
file, /sys/boot/isl, is written to the disk unless this option is used. 
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-usb [filename] 
Accept media defect information from the user. Input can be specified 
from file filename or from the terminal. To specify file input, filename must 
appear after -usb. If no filename follows the -usb option, /etc/format takes 
input for user specified bad block information from the user terminal. 


-maint 
Inhibit formatting, certifying, and writing an ISL to the disk; replace the 
bootblock if it is bad and replacement is possible; and accept media defect 
information. 


OUTPUT 


Error messages and phase messages are output on standard error. 


The bad block summary listing of the generated bad block table and the drive 
selection menu are output to standard output. 


INPUT DATA 


The media defect information consists of lines of input from a file or standard 
input. 


A line beginning with the # character is a comment. Null lines are ignored. A 
line beginning with a $ marks the end of input data; this line is not required if 
input is from a file. 


Data lines have one of three formats: 


b bn where bn is the block number. /etc/format marks the specified block as bad. 
This information generally comes from the system error log. NOTE : The 
defects from the system error log are only valid as long as the hardware 
interleave, sectors per track, and inter-sector gap are the same as when the 
disk was previously formatted and the error was reported. 


ct cn tn 
where cn is cylinder number and f is track number. /etc/format logs all 
blocks on the specified track as bad and moves them to the alternate area. 


ctb cn in bn 
where cn is cylinder, m is track, and bn is the byte offset of the media 
defect. Such information usually comes from the media defect sheet 
supplied with the drive. In this case the block(s) to be marked bad are 
calculated using interleave and byte offset as well as cylinder and head 
numbers. If the marked blocks are not in the maintenance area and the 
data can be read successfully, the blocks are moved. 
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For example, 
b 75 

specifies block 75, 
COZ 

specifies track 2 of cylinder 5, and 
ctb 10 2 10000 


specifies the block on cylinder 10, track 2 which contains the 10000th byte on 
track 2. This would be converted to a block number; the block preceding or the 
block following the one specified may also be logged depending on where in the 
block the defect was located. 


DIAGNOSTICS 
In the event of a fatal error, a non-zero exit status is returned. 


FILES 
/sys/boot/isl ISL 


RESTRICTIONS 
There is no mechanism for marking sectors bad in the alternate block area once 
they are assigned. This can be done with dd(1). However, the bad block table is 
updated so that the alternate is not used. 


format(1M) and dkpart(1M) can not be performed simultaneously on the system. 
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NAME 
( \ formatck - format checker for the 5.25 and 8 inch disks 


SYNOPSIS 
/etc/formatck -d device [-s] 


DESCRIPTION 
The command /etc/formatck checks the format for 5.25 and 8 inch Winchester 


disks. Error messages and phase messages are displayed on standard error. 
Invoking /etc/formatck with no options produces a help line giving a syntax | 
description with all option groups listed. 


OPTIONS 

The options may be specified in any order. The -d option is the only required | 

option. | 

-d device 

Use device as the name of the disk to be checked; device is the character | 

a special device representing partition 0 of the device (for example, | 
/dev/rdsk/0s0 for first 5.25 inch Winchester disk). | 

-s Do not operate in verbose mode. /etc/formatck displays phase messages to 

the screen in verbose mode. | 


DIAGNOSTICS 
In the event of an invalid format, a non-zero exit status is returned. 
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NAME 
frec - recover files from a backup tape 


SYNOPSIS 
/etc/frec [-p path] [-f reqfile] raw_tape 1_number:name ... 


DESCRIPTION 
The command frec recovers files from the specified raw_tape backup tape written 
by volcopy(1M) or finc(1M), given their i_nuwmbers. The data for each recovery 
request is written into the file given by name . 


The -p option allows you to specify a default prefixing path different from your 
current working directory. This is prefixed to any names that are not fully 
qualified, i.e., that do not begin with / or ./. If any directories are missing in the 
paths of recovery names they are created. 


-p path Specifies a prefixing path to be used to fully qualify any names 
that do not start with / or ./. 


-f reqfile Specifies a file which contains recovery requests. The format is 
i number:newname, one per line. 


EXAMPLES 
To recover a file, i-number 1216 when backed-up, into a file named junk in your 
current working directory: 


frec /dev/rmt/cCOd0v 1216:junk 


To recover files with i_ numbers 14156, 1232, and 3141 into files /usr/sre/cmd/a, 
/usr/src/emd/b and /usr/joe/a.c: 


frec -p /usr/src/emd /dev/rmt/cOdOv 14156:a 1232:b 
3141:/usr/joe/a.c 


SEE ALSO 
ff(1M), finc(1M), labelit(1M) 
cpio(1) in the User’s Reference Manual 


BUGS 
While paving a path (i.e., creating the intermediate directories contained in a 
pathname) frec can only recover inode fields for those directories contained on 
the tape and requested for recovery. 
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NAME 


fsck, dfsck - check and repair file systems 


SYNOPSIS 


fetc/fsck [-y] [-n] [-sX] [-SX] [-t file] [-q] [-D] [-f] [-b] [file-systems ] 
/etc/dfsck [options1] fsys1 ... - [options2] fsys2 ... 


DESCRIPTION 
The command fsck audits and interactively repairs inconsistent conditions for file 
systems. If the file system is found to be consistent, the number of files, blocks 
used, and blocks free are reported. If the file system is inconsistent the user is 
prompted for concurrence before each correction is attempted. It should be 
noted that most corrective actions result in some loss of data. The amount and 
severity of data loss may be determined from the diagnostic output. The default 
action for each correction is to wait for the user to respond yes or no. If the user 
does not have write permission fsck defaults to a -n action. 


The following options are accepted by fsck. 


“a 


-n 


-sX 


“SX 


UP-14805 


Assume a yes response to all questions asked by fsck. 


Assume a no response to all questions asked by fsck; do not open the file 
system for writing. 


Ignore the actual free list and (unconditionally) reconstruct a new one by 
rewriting the super-block of the file system. The file system should be 
unmounted while this is done; if this is not possible, care should be taken 
that the system is quiescent and that it is rebooted immediately 
afterwards. This precaution is necessary so that the old, bad, in-core copy 
of the superblock does not continue to be used, or written on the file 
system. 


The -sX option allows for creating an optimal free-list organization. 


If X is not given, the values used when the file system was created are 
used. The format of X is cylinder size:gap size. 


Conditionally reconstruct the free list. This option is like -sX¥ above except 
that the free list is rebuilt only if there were no discrepancies discovered 
in the file system. Using -S forces a no response to all questions asked by 
fsck. This option is useful for forcing free list reorganization on 
uncontaminated file systems. 


If fsck cannot obtain enough memory to keep its tables, it uses a scratch 
file. If the -t option is specified, the file named in the next argument is 
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“q 


-D 
-f 


-b 


used as the scratch file, if needed. Without the -t flag, fsck prompts the 
user for the name of the scratch file. The file chosen should not be on the 
file system being checked, and if it is not a special file or did not already 
exist, it is removed when fsck completes. 


Quiet fsck. Do not print size-check messages. Unreferenced fifos are 
silently removed. If fsck requires it, counts in the superblock are 
automatically fixed and the free list salvaged. 


Directories are checked for bad blocks. Useful after system crashes. 


Fast check. Check block and sizes and check the free list. The free list is 
reconstructed if it is necessary. 


Reboot. If the file system being checked is the root file system and 
modifications have been made, then either remount the root file system or 
reboot the system. A remount is done only if there was minor damage. 


If no file-systems are specified, fsck reads a list of default file systems from the 
file /etc/checklist. 


Inconsistencies checked are as follows: 


i, 
ea 


ey 
4, 


* 


SA 


Blocks claimed by more than one i-node or the free list. 
Blocks claimed by an i-node or the free list outside the range of the 
file system. 
Incorrect link counts. 
Size checks: 
Incorrect number of blocks. 
Directory size not 16-byte aligned. 
Bad i-node format. 
Blocks not accounted for anywhere. 
Directory checks: 
File pointing to unallocated i-node. 
I-node number out of range. 
Super Block checks: 
More than 65536 i-nodes. 
More blocks for i-nodes than there are in the file system. 
Bad free block list format. 


10. Total free block and/or free i-node count incorrect. 


Orphaned files and directories (allocated but unreferenced) are, with the user’s 
concurrence, reconnected by placing them in the lost + found directory, if the 
files are nonempty. The user is notified if the file or directory is empty or not. 


Empty 
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fsck forces the reconnection of nonempty directories. The name assigned is the 
i-node number. The only restriction is that the directory lost+ found must 
preexist in the root of the file system being checked and must have empty slots in 
which entries can be made. This is accomplished by making lost + found, copying 
a number of files to the directory, and then removing them (before fsck is 
executed). 


Checking the raw device is almost always faster and should be used with 
everything but the root file system. 


dfsck 
This version of the fsck command is appropriate only for computers only 
equipped with two or more hard disk drives. dfsck should not be used to check 
the root file system. 


dfsck allows two file system checks on two different drives stmultaneously. 
options1 and options2 are used to pass options to fsck for the two sets of file 
systems. A - is the separator between the file system groups. 


The dfsck program permits a user to interact with two fsck programs at once. To 
aid in this, dfsck prints the file system name for each message to the user. When 
answering a question from dfsck, the user must prefix the response with a 1 or a 
2 (indicating that the answer refers to the first or second file system group). 


FILES 
/etc/checklist contains default list of file systems to check 


SEE ALSO 
mkfs(1M), ncheck(1M), crash(1M) 
uadmin(2), checklist(4), fs(4) in the Programmer’s Reference Manual 


BUGS 
IJ-node numbers for . and .. in each directory are not checked for validity. 
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NAME 
rr fsdb - file system debugger 


SYNOPSIS 
/etc/fsdb special [ - ] 


DESCRIPTION 
The command fsdb can be used to patch up a damaged file system after a crash. 
It has conversions to translate block and i-numbers into their corresponding disk 
addresses. Also included are mnemonic offsets to access different parts of an 1- 
node. These greatly simplify the process of correcting control block entries or 
descending the file system tree. 


fsdb contains several error-checking routines to verify i-node and block 
addresses. These can be disabled if necessary by invoking fsdb with the optional 
- argument or by the use of the O symbol. (fsdb reads the i-size and f-size entries 
from the superblock of the file system as the basis for these checks.) 


Numbers are considered decimal by default. Octal numbers must be prefixed 
rr" with a zero. During any assignment operation, numbers are checked for a 
possible truncation error due to a size mismatch between source and destination. 


fsdb reads a block at a time and therefore works with raw as well as block I/O. A 
buffer management routine is used to retain commonly used blocks of data in 
order to reduce the number of read system calls. All assignment operations 
result in an immediate write-through of the corresponding block. 


The symbols recognized by fsdb are: 

absolute address 

convert from i-number to i-node address 
convert to block address 
directory slot offset 
address arithmetic 

quit 

save, restore an address 
numerical assignment 
incremental assignment 
decremental assignment 
character string assignment 
error checking flip flop 
general print facilities 

file print facility 


~~ 


~~ 


+> 


# 

i 

b 

d 

of 

q 
>,< 
O 

Pp 

f 
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byte mode 

word mode 

double word mode 
escape to shell 


ie a a 


The print facilities generate a formatted output in various styles. The current 
address is normalized to an appropriate boundary before printing begins. It 
advances with the printing and is left at the address of the last item printed. The 
output can be terminated at any time by typing the delete character. If a number 
follows the p symbol, that many entries are printed. A check is made to detect 
block boundary overflows since logically sequential blocks are generally not 
physically sequential. If a count of zero is used, all entries to the end of the 
current block are printed. The print options available are: 

print as i-nodes 

print as directories 

print as octal words 

print as decimal words 

print as characters 

print as octal bytes 


The f symbol is used to print data blocks associated with the current i-node. If 
followed by a number, that block of the file is printed. (Blocks are numbered 
from zero.) The desired print option letter follows the block number, if present, 
or the f symbol. This print facility works for small as well as large files. It checks 
for special devices and that the block pointers used to find the data are not zero. 


Dots, tabs, and spaces may be used as function delimiters but are not necessary. 
A line with just a new-line character increments the current address by the size 
of the data type last printed. That is, the address is set to the next byte, word, 
double word, directory entry or i-node, which allows you to step through a region 
of a file system. Information is printed in a format appropriate to the data type. 
Bytes, words and double words are displayed with the octal address followed by 
the value in octal and decimal. A .B or .D is appended to the address for byte 
and double word values, respectively. Directories are printed as a directory slot 
offset followed by the decimal i-number and the character representation of the 
entry name. I-nodes are printed with labeled fields describing each element. 


The following mnemonics are used for i-node examination and refer to the 
current working i-node: 


md mode 
In link count 
uid user ID number 
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gid 
SZ 
a# 
at 
mt 
maj 
min 
EXAMPLES 
3861 


In=4 
In=+1 
fc 


2i.£d 


d51.fc 


512B.p0o0 
21.a0b.d7 =3 


d7.nm = "name" 


a2b.p0d 


SEE ALSO 
fsck(1M) 


FSDB(1M) 


group ID number 

file size 

data block numbers (0 - 12) 
access time 

modification time 

major device number 

minor device number 


prints i-number 386 in an i-node format. This now becomes 
the current working i-node. 


changes the link count for the working 1-node to 4. 
increments the link count by 1. 

prints, in ASCII, block zero of the file associated with the 
working i-node. 

prints the first 32 directory entries for the root i-node of this 
file system. 


changes the current i-node to that associated with the 5th 
directory entry (numbered from zero) found from the above 
command. The first logical block of the file is then printed in 
ASCII. 


prints the superblock of this file system in octal. 


changes the i-number for the seventh directory slot in the root 
directory to 3. This example also shows how several 
operations can be combined on one command line. 


changes the name field in the directory slot to the given string. 
Quotes are optional when used with nm if the first character is 
alphabetic. 


prints the third block of the current i-node as directory 
entries. 


dir(4), fs(4) in the Programmer’s Reference Manual 
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NAME 
fsstat - report file system status 


SYNOPSIS 
/etc/fsstat special_file 


DESCRIPTION 
The command fsstat reports on the status of the file system on special_file . 
During startup, this command is used to determine if the file system needs 
checking before it is mounted. fsstat succeeds if the file system is unmounted 
and appears okay. For the root file system, it succeeds if the file system is active 
and not marked bad. 


SEE ALSO 
fs(4) in the Programmer’s Reference Manual 


DIAGNOSTICS 
The command has the following exit codes: 


0 -- the file system is not mounted and appears okay, 
(except for root where 0 means mounted and okay). 

1 -- the file system is not mounted and needs to be checked. 

2 -- the file system is mounted. 

3 -- the command failed. 
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NAME 
fstyp - determine file system identifier 


SYNOPSIS 
letc/fstyp special 


DESCRIPTION 
The command fstyp allows the user to determine the file system identifier of 
mounted or unmounted file systems using heuristic programs. The file system 
type is required by mount(2) and sometimes by mount(1M) to mount file systems 
of different types. 


The directory /etc/fstyp.d contains a program for each file system type to be 
checked; each of these programs applies some appropriate heuristic to determine 
whether the supplied special file is of the type for which it checks. If it is, the 
program prints on standard output the usual file-system identifier for that type 
and exits with a return code of 0; otherwise it prints error messages on standard 
error and exits with a non-zero return code. fstyp runs the programs in 
/etc/fstyp.d in alphabetical order, passing special as an argument; if any program 
succeeds, its file-system type identifier is printed and fstyp exits immediately. If no 
program succeeds, fstyp prints "Unknown_fstyp" to indicate failure. 


WARNINGS 
The use of heuristics implies that the result of fstyp is not guaranteed to be 
accurate. 


SEE ALSO 
mount(1M) 
mount(2), sysfs(2) in the Programmer’s Reference Manual 
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NAME 
fumount - forced unmount of an advertised resource 


SYNOPSIS 
fumount [-w sec] resource 


DESCRIPTION 
The command fumount unadvertises resource and disconnects remote access to 
the resource. The -w sec causes a delay of sec seconds prior to the execution of 
the disconnect. 


When the forced unmount occurs, an administrative shell script is started on each 
remote computer that has the resource mounted (/usr/bin/rfuadmin). If a grace 
period of seconds is specified, rfuadmin is started with the fuwarn option. When 
the actual forced unmount is ready to occur, rfuadmin is started with the 
fumount option. See the rfuadmin(1M) man page for information on the action 
taken in response to the forced unmount. 


This command is restricted to the superuser. 


ERRORS 
If resource (1) does not physically reside on the local machine, (2) is an invalid 
resource name, (3) is not currently advertised and is not remotely mounted, or 
(4) the command is not run with superuser privileges, an error message is sent to 
standard error. 


SEE ALSO 
adv(1M), mount(1M), rfuadmin(1M), rfudaemon(1M), rmount(1M), unadv(1M) 
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NAME 
fusage - disk access profiler 


SYNOPSIS 
fusage [[mount_point] | [advertised_resource] | (block_special_device] {...]] 


DESCRIPTION 
When used with no options, fusage reports block i/o transfers, in kilobytes, to and 
from all locally mounted file systems and advertised Remote File Sharing 
resources on a per client basis. The count data are cumulative since the time of 
the mount. When used with an option, fusage reports on the named file system, 
advertised resource, or block special device. 


The report includes one section for each file system and advertised resource and 
has one entry for each machine that has the directory remotely mounted, ordered 
by decreasing usage. Sections are ordered by device name. Advertised resources 
that are not complete file systems immediately follow the sections for the file 
systems they are in. 


SEE ALSO 
adv(1M), mount(1M), df(1M), crash(1M) 
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NAME 
fuser - identify processes using a file or file structure 


SYNOPSIS 
/etc/fuser [-ku] [-s sys name] files ... 


DESCRIPTION 
The command fuser lists the process IDs of the processes using the files specified 
as arguments. For block special devices, all processes using any file on that 
device are listed. The process ID is followed by an informative letter: 


c The process is using the file as its current directory. 


p __ The process is using the file as the parent of its current directory (only 
when in use by the system). 


r The process is using the file as its root directory. 


fuser prints the process IDs as a single line on the standard output separated by 
spaces and terminated with a single new line. All other output is written on 
standard error. 


OPTIONS 
Options may be respecified between groups of files. The new set of options 
replaces the old set with a lone dash canceling any options currently in force. 


-u_ Follow the process ID with the login name in parentheses. 


-k Send the SIGKILL signal to each process. Only the superuser can 
terminate a process belonging to another user [see A//(2)]. 


-S Sys_name 
Specify the system name under which you are booted. If the -s option is 
omitted, /unix is assumed. 


EXAMPLES 
fuser -ku /dev/dsk/Os1 


terminates all processes that are preventing dsk/0s1 from being unmounted 


when this command is typed by the superuser, listing the process ID and 
login name of each as it is killed. 


UP-14805 Page 1 


FUSER (1M) 


fuser -u /etc/passwd 


lists process IDs and login names of processes that have the password file Na 
open. 


FILES 
/unix for namelist 
/dev/mem for system image 
/dev/mem also for system image 


SEE ALSO 
mount(1M) 
ps(1) in the User’s Reference Manual 
kill(2), signal(2) in the Programmer’s Reference Manual 
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NAME 
F (N fwtmp, wtmpfix - manipulate connect accounting records 


SYNOPSIS 
/usr/lib/acct/fwtmp [-ic] 
/usr/lib/acct/wtmpfix [files] 


DESCRIPTION 
The command fwimp reads from the standard input and writes to the standard 
output, converting binary records of the type found in wep to formatted ASCII 
records. The ASCII version is useful to enable editing, using ed(1), bad records 
or general purpose maintenance of the file. 


The argument -ic is used to denote that input is in ASCII form, and output is to 
be written in binary form. 


wtmpfix examines the standard input or named files in wimp format, corrects the 
time/date stamps to make the entries consistent, and writes to the standard 
output. A - can be used in place of files to indicate the standard input. If 

om time/date corrections are not performed, acctcon(1) faults when it encounters 
certain date-change records. 


Each time the date is set, a pair of date change records are written to /etc/wimp. 
The first record is the old date denoted by the string old time placed in the line 
field and the flag OLD_TIME placed in the type field of the <utnp.h> 
structure. The second record specifies the new date and is denoted by the string 
new time placed in the line field and the flag NEW_TIME placed in the type 
field. wtmpfix uses these records to synchronize all time stamps in the file. 


In addition to correcting time/date stamps, wenpfix checks the validity of the 
name field to ensure that it consists solely of alphanumeric characters or spaces. 
If it encounters a name that is considered invalid, it changes the login name to 
INVALID and writes a diagnostic to the standard error. In this way, wenpfix 
reduces the chance of acctcon(1M) failing when processing connect accounting 
records. 


FILES 


f™ /etc/wtmp 
| /usr/include/utmp.h 
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SEE ALSO 
acct(1M), acctcems(1M), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), | 
runacct(1M) Ww 
acctcom(1), ed(1) in the User’s Reference Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 
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NAME 
getty - set terminal type, modes, speed, and line discipline 


SYNOPSIS 
/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ linedisc ] ] ] 
/etc/getty -c file 


DESCRIPTION 
The getty program is invoked by init(1M). It is the second process in the series, 
(init-getty-login-shell) that ultimately connects a user with the UNIX system. It 
can only be executed by the superuser; that is, a process with the user-ID of root. 
Initially getty prints the login message field for the entry it is using from 
/etc/gettydefs. getty reads the user’s login name and invokes the /ogin (1) 
command with the user’s name as argument. While reading the name, getty 
attempts to adapt the system to the speed and type of terminal being used. It 
does this by using the options and arguments specified. 


Line is the name of a tty line in /dev to which getty is to attach itself. getty uses 
this string as the name of a file in the /dev directory to open for reading and 
writing. Unless getty is invoked with the -h flag, getty forces a hangup on the line 
by setting the speed to zero before setting the speed to the default or specified 
speed. The -t flag plus timeout (in seconds), specifies that getty should exit if the 
open on the line succeeds and no one types anything in the specified number of 
seconds. 


Speed, the optional second argument, is a label to a speed and tty definition in 
the file /etc/gettydefs. This definition tells getty at what speed to initially run, 
what the login message should look like, what the initial tty settings are, and what 
speed to try next should the user indicate that the speed is inappropriate (by 
typing a <break> character). The default speed is 300 baud. 


Type, the optional third argument, is a character string describing to getty what 
type of terminal is connected to the line in question. getty recognizes the 


following types: 
none default 
ds40-1 Dataspeed40/1 
tektronix,tek Tektronix 
vt61 DEC vt6l 
vt100 DEC vt100 
hp45 Hewlett-Packard 45 
c100 Concept 100 
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The default terminal is none; i.e., any CRT or normal terminal unknown to the 
system. Also, for terminal type to have any meaning, the virtual terminal 
handlers must be compiled into the operating system. They are available, but not 
compiled, in the default condition. 


Linedisc, the optional fourth argument, is a character string describing which line 
discipline to use in communicating with the terminal. Again the hooks for line 
disciplines are available in the operating system but there is only one presently 
available, the default line discipline, LDISCO. 


When given no optional arguments, getty sets the speed of the interface to 300 
baud, specifies that raw mode is to be used (awaken on every character), that 
echo is to be suppressed, either parity allowed, newline characters are converted 
to carriage return-line feed, and tab expansion performed on the standard 
output. It types the login message before reading the user’s name a character at 
a time. If a null character (or framing error) is received, it is assumed to be the 
result of the user pushing the "break" key. This causes getty to attempt the next 
speed in the series. The series that getty tries is determined by what it finds in 
/etc/gettydefs. 


After the user’s name has been typed in, it is terminated by a newline or 
carriage-return character. The latter results in the system being set to treat 
carriage returns appropriately [see ioctl (2)]. 


The user’s name is scanned to see if it contains any lowercase alphabetic 
characters; if not, and if the name is non-empty, the system is told to map any 
future uppercase characters into the corresponding lowercase characters. 


Finally, Jogin is exec’d with the user’s name as an argument. Additional 
arguments may be typed after the login name. These are passed to login, which 
places them in the environment [see /ogin(1)]. 


A check option is provided. When getty is invoked with the -c option and file, it 
scans the file as if it were scanning /etc/gettydefs and prints out the results to the 
standard output. If there are any unrecognized modes or improperly constructed 
entries, it reports these. If the entries are correct, it prints out the values of the 
various flags. See ioct/(2) to interpret the values. Note that some values are 
added to the flags automatically. 


FILES 
/etc/gettydefs 
/etc/issue 
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SEE ALSO 
a init(1M), tty(7) 
| ct(1C), login(1) in the User’s Reference Manual 
ioctl(2), gettydefs(4), inittab(4) in the Programmer’s Reference Manual 


BUGS 
While getty understands simple single character quoting conventions, it is not 
possible to quote certain special control characters used by getty. Thus, you 
cannot log in with getty and type a #, @, /, !, _, backspace, ~U, ~D, or & as 
part of your login name or arguments. getty uses them to determine when the 
end of the line has been reached, which protocol is being used, and what the 
erase character is. They are always interpreted as having their special meaning. 
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NAME 
| ™ icheck - find block in the file system 


| SYNOPSIS 
icheck [blocks] file_system 


DESCRIPTION 
The command icheck searches the file system for the specified block or blocks 
and prints the results on standard output. If the block is associated with a regular 
file, a directory, or a pipe, the inode number is printed as well as the location 
within the file system. If the block is in the freelist, "free" is printed. 


The blocks to be located may be specified in octal (prefix block number with 0), 
decimal, or hexadecimal (prefix block number with 0x). If no blocks are 
specified, all blocks found in the file system, directories, pipes, and the freelist 
are printed. Any block number may be specified and searched for, even those not 
in the file system. This is useful for finding garbage block values. 


| EXAMPLES 

(TT 1935: 12[3] 

| Block 1935 found on inode 12 as direct block 3. 

| 1776: free 

| Block 1776 found in the free list. 

| 1492: 450[12][3] 

| Block 1492 found on inode 450 as an indirect block (number 3) on triple 
| indirect chain. 


RESTRICTIONS 
Block 0 may be specified but it never is found due to the unique use of block 0 
pointers in the file system. 


While searching, block chains are traced as long as the blocks are readable, even 
when outside of the file system or in the inode area. 


SEE ALSO 


fsck(1M) 
fs(4), inode(4) in the Programmer’s Reference Manual 


ie 
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NAME 
idload - Remote File Sharing user and group mapping 


SYNOPSIS 
idload [-n] [ -k ] [-g g mules] [-u u_nules] [directory] 


DESCRIPTION 
The command idload is used on Remote File Sharing server machines to build 
translation tables for user and group IDs. It takes your /etc/passwd and 
/etc/group files and produces translation tables for user and group IDs from 
remote machines, according to the rules set down in the u_rules and g mules files. 
If you are mapping by user and group name, you need copies of remote 
/etc/passwd and /etc/group files. If no rules files are specified, remote user and 
group IDs are mapped to MAXUID +1 (this is an ID number that is one higher 
than the highest number you could assign on your system.) | 


By default, the remote password and group files are assumed to reside in 
/usr/nserve/auth.info/domain/host/[passwd| group]. The directory argument 
indicates that some directory structure other than /usr/nserve/auth.info contains 
the domain/host passwd and group files. (host is the name of the host the files 
are from and domain is the domain that host is a member of.) 


This command is run automatically when the first remote mount is done of a 
remote resource [see mount(1M)]. 


-n This is used to do a trial run of the ID mapping. The translation 
table is not produced, however, a display of the mapping is output to 
the terminal (stdout). 


-k This is used to print the ID mapping that is currently in use. 
(Specific mapping for a remote machines is not shown until that 
machine mounts one of your resources.) 


-uu_rules The w_rules file contains the rules for user ID translation. The 
default rules file is /usr/nserve /auth.info/uid.rules. 


-gg rules Theg rules file contains the rules for group ID translation. The 
default rules file is /usr/nserve /auth.info/gid.rules. 


This command is restricted to the superuser. 


RULES 
The rules files have two types of sections, both optional: global and host. There 
can be only one global section, though there can be one host section for each 
host you want to map. 
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The global section describes the default conditions for translation for any 
machines that are not explicitly referenced in a host section. If the global section 
is missing, the default action is to map all remote user and group IDs from 
undefined hosts to MAXUID +1. The syntax of the first line of the global 
section is: 

global 
A host section is used for each client machine or group of machines that you 


want to map differently from the global definitions. The syntax of the first line of 
each host section is: 


host name [...] 
where name is replaced by the full name(s) of a host (domain.host). 


The format of a rules file is described below. (All lines are optional, but must 
appear in the order shown.) 


global 

default /Jocal | transparent 

exclude /remote_id-remote_id] | [remote_id] 
map /remote_id:local] 


host domain.hostname [domain.hostname...] 

default /ocal | transparent 

exclude /remote_id-remote_id] | [remote_id] | [remote_name] 
map /remote:local] | remote | all 


Each of these instruction types is described below. 
The line: 


default /ocal | transparent 


defines the mode of mapping for remote users that are not specifically mapped in 
instructions in other lines. transparent means that all remote user and group IDs 
have the same numeric value locally unless they appear in the exclude instruction. 
local can be replaced by a local user name or ID to map all users into a 
particular local name or ID number. If the default line is omitted, all users that 
are not specifically mapped are mapped into a "special guest" login ID. 


The line: 


exclude [remote_id-remote_id] | [remote_id] | [remote_name] 
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defines remote IDs that are excluded from the default mapping. The exclude 
instruction must precede any map instructions in a block. You can use a range 
of ID numbers, a single ID number, or a single name. (remote_name cannot be 
used in a global block.) 


The line: 
map /remote-local] | remote | all 


defines the local IDs and names that remote IDs and names are mapped into. 
remote is either a remote ID number or remote name; /ocal is either a local ID 
number or local name. Placing a colon between a remote and a local gives the 
value on the left the permissions of the value on the right. A single remote name 
or ID assigns the user or group permissions of the same local name or ID. all is 
a predefined alias for the set of all user and group IDs found in the local 
/etc/passwd and /etc/group files. (You cannot map by remote name in global 
blocks.) 


NOTE: idload always outputs warning messages for map all, since password files 
always contain multiple administrative user names with the same ID number. If 
the first mapping attempt on the ID number succeeds, all subsequent attempts 
fail 


Remote File Sharing doesn’t need to be running to use idload. 


EXIT STATUS 
On successful completion, idload produces one or more translation tables and 
returns a successful ext status. If idload fails, the command returns an 
unsuccessful exit status without producing a translation table. 


ERRORS 
If (1) Neither the g rules or u_rules files can be found or opened, (2) there are 
syntax errors in the rules file, (3) there are semantic errors in the rules file, (4) 
host information can not be found, or (5) the command is not run with superuser 
privileges, an error message is sent to standard error. Partial failures cause a 
warning message to appear, though the process continues. 


FILES 
/etc/passwd 
/etc/group 
/usr/nserve/auth.info/domain/host/[user| group] 
/usr/nserve/auth.info/vid.rules 
/usr/nserve/auth.info/gid.rules 


UP-14805 Page 3 


IDLOAD (1M) 


SEE ALSO 
mount(1M) ii» 
"Remote File Sharing" chapter of the Administration Guide for detailed , 


information on ID mapping 
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; NAME 
| o™ ifind - see if a module is in a Stream 


SYNOPSIS 
/usr/lib/setterm/ifind name 


DESCRIPTION 
ifind takes one argument which is assumed to be the name of a configured 
STREAMS module. It uses a streario(7) call to determine whether the named 
module is in its standard input Stream. If the module is there, its name is printed 
to the standard output. If the module is not in the Stream, the word "(null)" is 
printed. If the standard input device is not a STREAMS device, or on other 
failure, the word "(invalid)" is printed. 


RETURN VALUES 
The exit value is 0 if the module is in the Stream, 1 otherwise. 


| SEE ALSO 
streamio(7) 
c~ 


| 


ae 
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NAME 
rn ilook - see what is in a Stream 


SYNOPSIS 
ilook 


DESCRIPTION 
The ilook command returns, to its standard output, the name of the top-most 
module in its standard input Stream. Usually, the standard I/O Streams are 
associated with the user’s tty. It uses a streamio(7) call to determine the name. 
On any error, or if there are no modules in the Stream, the word null is printed. 


EXIT CODES 
The exit value is 0 if there are any modules in the Stream, 1 otherwise. 


SEE ALSO 
streamio(7) 
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NAME 
r= init, telinit - process control initialization 


SYNOPSIS 
/etc/init [0123456SsQqabc ] 


/bin/telinit [0123456sSQqabc | 


DESCRIPTION 
The command init is a general process spawner. Its primary role is to create 
processes from a script stored in the file /etc/inittab [see inittab(4)]. 


In a multi-user environment, the inittab file is usually set up so that init creates a 
process (such as getty) for each terminal on the system. 


init also controls autonomous processes required by any particular system. 


init considers the system to be in a run-level at any given time. A run-level can be 
viewed as a software configuration of the system where each configuration 
a permits only a selected group of processes to exist. 


init can be in one of eight run-levels, 0-6 or S (or s). 


A privileged user may change the run-level by running /etc/init (which is linked to 
/bin/telinit). This user-spawned init sends appropriate signals to the original init 
spawned by the operating system when the system was rebooted, telling it which 
run-level to change to. 


The processes spawned by init for each of these run-levels are defined in the 
inittab file. 


Invocation 
init is invoked inside the UNIX system as the last step in the boot procedure. 
The first thing init does is to look for /etc/inittab and see if there is an entry of the 
type initdefault [see inittab(4)]. If there is, init uses the run-level specified in that 
entry as the initial run-level to enter. If /etc/inittab does not exist, then by default 
the only run-level that init can enter is the SINGLE USER level. 


If this entry is not in inittab or inittab is not found, init requests that the user 
f~ enter a run-level from the system console, /dev/syscon. 


If the user enters an S (s), init goes into the SINGLE USER level. This is the 
only run-level that does not require the existence of a properly formatted inittab 
file. 


In the SINGLE USER level, init opens the virtual console terminal /dev/syscon for 
reading and writing, and invokes the command /bin/su immediately. To exit from 
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the SINGLE USER run-level one of two options can be elected: 
1) terminate the shell using an end-of-file. init prompts for a new run-level. 


2) signal init using the init or telinit which can force it to change the run-level 
of the system. 


Failure of Invocation 
When attempting to boot the system, failure of init to prompt for a new run-level 
may occur if the device /dev/syscon is linked to a device other than the physical 
system teletype /dev/systty. 


When init prompts for the new run-level, the operator may only enter one of the 
digits 0 through 6 or the letters S or s. 


If S is entered, init operates as previously described in SINGLE USER mode 
with the additional result that /dev/syscon is linked to the terminal line of the 
user, thus making it the system console. init issues a message on the physical 
console, /dev/systty, saying where the system console terminal has been relocated. 


Normal Execution 
When init comes up initially and switches out of SINGLE USER state to normal 
run states, it sets the ioctl(2) states of the system console, /dev/syscon, to those 
modes saved in the file /etc/ioctl.syscon. init writes to this file by init whenever 
SINGLE USER mode is entered. If this file does not exist when init wants to 
read it, init issues a warning and assumes default settings. 


When changing run-levels, if a 0 through 6 is entered, init enters the 
corresponding run-level. Any other input is rejected and the user is prompted 
again. 


If this is the first time init has entered a run-level other than SINGLE USER, init 
first scans inittab for special entries of the type boot and bootwait. These entries 
are performed, providing the run-/evel entered matches that of the entry before 
any normal processing of inittab takes place. 


This permits any special initialization of the operating system, such as mounting 
file systems, to take place before users are permitted onto the system. init then 
scans the inittab file to find all entries that are to be processed for that run-level. 


To spawn each process in the inittab file, init reads each entry and for each entry 
which should be respawned, it forks a child process. 


After it has spawned all of the processes specified by the inittab file, init waits for 
one of its descendant processes to die, a powerfail signal, or until init is signaled 
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aN by init or telinit to change the system’s run-level. When one of the above three 
| } ‘conditions occurs, init re-examines the inittab file. 


A history of the processes spawned is kept in /etc/wtmp if such a file exists. 


For terminal processes, ultimately the shell terminates because of an end-of-file 
either typed explicitly or generated as the result of hanging up. 


When init receives a child death signal, telling it that a process it spawned has 
died, it records the fact and the reason it died in /etc/utmp and /etc/wtmp if it 
exists [see who(1)]. 


New entries can be added to the inittab file at any time; however, init still waits 
for one of the above three conditions to occur. 


To provide for an instantaneous response the init Q or init q command can wake 
init to re-examine the inittab file. 


Powerfail 

| If init receives a powerfail signal (SIGPWR) and is not in SINGLE USER mode, 

om it scans inittab for special powerfail entries. These entries are invoked (if the 
run-levels permit) before any further processing takes place. This permits init to 
perform various cleanup and recording functions whenever the system 
experiences a power failure. 


telinit Requests 
When telinit requests init to change run-levels, init sends the warning signal 
(SIGTERM) to all processes that are undefined in the target nun-level. init waits 
20 seconds before forcibly terminating these processes using the kill signal 
(SIGKILL). 
h telinit 
| telinit, which is linked to /etc/init, is used to direct the actions of init by a one 
character argument, and signals init using the kill system call to perform the 
| appropriate action. 


| The following arguments serve as directives to init. 


0-6 Tells init to place the system in one of the run-levels 0-6. 

| f~ a,b,c Tells init to process only those /etc/inittab file entries having the a, b or 
, c run-level set. 

| Q.q Tells init to re-examine the /etc/inittab file. 

| s,S Tells init to enter the single user environment. When this level change 


is effected, the system console, /dev/syscon, is changed to the terminal 
from which the command was executed. 
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telinit can only be run by someone who is superuser or a member of group sys. 


FILES 
/etc/inittab 
/etc/utmp 
/etc/wtmp 
/etc/ioctl.syscon 
/dev/syscon 
/dev/systty 


SEE ALSO 
getty(1M) 
login(1), sh(1), who(1), in the User’s Reference Manual 
kill(2), inittab(4), utmp(4) in the Programmer’s Reference Manual 


DIAGNOSTICS 
If init finds that it is continuously respawning an entry from /etc/inittab more than 
10 times in 2 minutes, it assumes that there is an error in the command string, 
generates an error message on the system console, and refuses to respawn this 
entry until either 5 minutes have elapsed or it receives a signal from a user init 
(telinit). 


This prevents init from overusing system resources when someone makes a 
typographical error in the inittab file or a program is removed that is referenced 
in inittab. 


RESTRICTIONS 
All entries of a run-level are spawned before init changes to a different run-level. 
Consequently, all multi-user entries are started even though the file system check 
(/etc/bcheckrc) failed. As soon as all the multi-user entries are started, init kills all 
those not associated with the new run-level 0. 
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NAME 
( \ install - install commands 


SYNOPSIS 
/etc/install [-c dira] [-f dirb] [-i] [-n dirc] [-m mode] [-u user] [-g group] [-o] 
[-s] file [dirx ...] 


DESCRIPTION 
The install command is most commonly used in "makefiles" [See make(1)] to 
install a file (updated target file) in a specific place within a file system. Each 
file is installed by copying it into the appropriate directory, thereby retaining the 
mode and owner of the original command. The program prints messages telling 
the user exactly what files it is replacing or creating and where they are going. 


If no options or directories (dirx ...) are given, install searches a set of default 

directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) for a file with the 

same name as file. When the first occurrence is found, install issues a message 

saying that it is overwriting that file with file, and proceeds to do so. If the file is 
oo not found, the program states this and exits without further action. 


If one or more directories (dirx ...) are specified after file, those directories are 
searched before the directories specified in the default list. 


The meanings of the options are: 


-c dira Installs a new command (file) in the directory specified 
by dira, only if it is not found. If it is found, install issues 
a message saying that the file already exists, and exits 
without overwriting it. May be used alone or with the -s 
option. 


-f dirb Forces file to be installed in given directory, whether or 
not one already exists. If the file being installed does not 
already exist, the mode and owner of the new file are set 
to 755 and bin, respectively. If the file already exists, the 
mode and owner are the same as the already existing file. 
May be used alone or with the -o or -s options. 


—— ' -i Ignores default directory list, searching only through the 
given directories (dirx ...). May be used alone or with 
any other options except -c and -f. 


-n dirc If file is not found in any of the searched directories, it is 
put in the directory specified in dirc. The mode and 
owner of the new file are set to 755 and bin, respectively. 
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“u user 


“& group 


-0 


-S 


SEE ALSO 


May be used alone or with any other options except -c 
and -f. 


The mode of the new file is set to mode. Only available 
to the superuser. 


The owner of the new file is set to user. Only available to 
the superuser. 


The group ID of the new file is set to group. Only 
available to the superuser. 


If file is found, this option saves the "found" file by 
copying it to OLDfile in the directory in which it was 
found. This option is useful when installing a frequently 
used file such as /bin/sh or /etc/getty, where the existing 
file cannot be removed. May be used alone or with any 
other options except -c. 


Suppresses printing of messages other than error 
messages. May be used alone or with any other options. 


make(1) in the Programmer’s Reference Manual 
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NAME 
f \ kbdload - load or link kbd tables 


SYNOPSIS 
kbdload [ -p ] filename 
kbdload -u table 
kbdload {-L1} string 


| DESCRIPTION 

; Tables included in the file filename are loaded into the kbd(7) module, which 
must already have been pushed into the standard input Stream. (In this context, 
| loaded means copied from a disk file into main memory within the operating 

, system.) This program is intended both to provide for loading and linking of 

| both shared or public tables and private tables implementing user-specific 

| functionality. New users should refer to kbdcomp(1M) and kbd(7) for a general 
| description of the module’s capabilities. 


Files are searched for only by the name given on the command line; no search 
| o™ path is implied. Tables loaded by the superuser with the -p option from an 

| absolute path beginning at /usr/lib/kbd are made publicly available and 
permanently resident; otherwise the loaded tables are available only to the caller, 
and are automatically unloaded when the kbd module is popped from the Stream. 


The -u option can be used to unload private tables and by the superuser to 
remove public tables. Tables may be unloaded only if they are not currently in 
use. (Tables which are members of composite tables always have nonzero 
reference counts since they are used in the composite; all composites which refer 
to them must be unloaded first.) 


The -L and -1 options are used for making composite tables on-the-fly. The -L 
option, if executed by the superuser, causes the composite to be made publicly 
available; it is otherwise private and -L is equivalent to -l. The string argument is 
constructed in the same manner as the link statement (see kbdcomp(1M)) in the 
compiler. If any component of the intended composite is not presently loaded in 
memory or if a component of a public table is not also public, an error message 
is printed and the linkage fails. More than one composite may be created in a 
“™ single invocation by using either option sequentially. 
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Security Issues 
Allowing users other than the superuser to load public tables is a security risk 
and is thus disallowed. (In general, any manipulation of a module instance by a 
user who is neither the superuser nor the user who originally pushed it is 
disallowed.) The library directory and all files contained in it should be 
protected by being unwriteable. Administrators are encouraged to remember 
that the kbd system can be used to arbitrarily remap the entire keyboard of a 
terminal, as well as the entire output Stream; thus, in extremely hostile 
environments, it might be prudent to remove execution permissions from kbdload 
for nonadministrative users (e.g., setting the owner to bin or root and giving it a 
mode of 0500). 


The kbdload command checks to insure that the real uid of the invoker is the 
same as the owner of both the standard input and standard output file, unless the 
real uid of the invoking user is the superuser. Paths to public tables are 
scrutinized for legitimacy. The kbdload command refuses to work as a set uid 
program. 


FILES 
/user/lib/kbd - directory containing system standard map files 


SEE ALSO 
kbdcomp(1M), kbdset(1), kbd(7) 


EXIT VALUES 
Exit value is 0 if all tables could be loaded and/or all operations succeeded. In 
the event of any I/O error (example: attempting to load a table with the same 
name as one already loaded and accessible to the caller) or failure to load a 
table, exit stake is 1 and a message is printed indicating the error. 


BUGS 
Composite tables may be unloaded while they are actually in use without 
affecting current users, though new users may no longer attach to them. This is 
because composite tables are copied and expanded when they are attached in 
order to keep state information related to the attached user. The original 
composite always has a zero reference count, and is never itself attached. This is 
not strictly a bug, but an anomaly; the effect on the user is that a composite table 
may be attached and functional, yet not appear in the output of a kbdset(1) 


query. 
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NAME 
-killall - kill all active processes 


SYNOPSIS 
/etc/killall [ signal ] 


DESCRIPTION 
The command Killall is used by /etc/shutdown to kill all active processes not 
directly related to the shutdown procedure. 


killall terminates all processes with open files so the mounted file systems are 
closed and can be unmounted. 


killall sends signal [see kill(1)] to all processes not belonging to the above group 
of exclusions. If no signal is specified, a default of 9 is used. 


FILES 
/etc/shutdown 


SEE ALSO 
fuser(1M), shutdown(1M) 
kill(1), ps(1) in the User’s Reference Manual 
signal(2) in the Programmer’s Reference Manual 


WARNINGS 
The Killall command can be run only by the superuser. 
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NAME 
| iy labelit - provide labels for file systems 


SYNOPSIS 
/etc/labelit special [ fsname volume [ -n ] | 


DESCRIPTION 
The command /abelit can be used to provide labels for unmounted disk file 
systems or file systems being copied to tape. The -n option provides for initial 
labeling only (this destroys previous contents). 


With the optional arguments omitted, /abelit prints current label values. 


The special name should be the physical disk section (e.g., /dev/dsk/c0d0s6), or 
the cartridge tape (e.g., /dev/rmt/c0d0v). The device may not be on a remote 
machine. 


The fsname argument represents the mounted name (e.g., root, ul, etc.) of the 
file system. 


a Volume may be used to equate an internal name to a volume name applied 
externally to the disk pack, diskette or tape. 


For file systems on disk, fsname and volume are recorded in the superblock. 


SEE ALSO 
sh(1) in the User’s Reference Manual 
fs(4) in the Programmer’s Reference Manual 
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NAME 
™ Idhpsio - high performance serial I/O module loader 


SYNOPSIS 
/etc/ldhpsio fn devil [ dev2 ... | 


DESCRIPTION 
The command /dhpsio loads the object code in fn for the high performance serial 
I/O device(s) (HPSIO) for execution by the microprocessor on each device. Fn 
must be in a.out format and linked for HPSIO execution. 


Idhpsio attempts to open each device in the device list. For each successful open, 
ldhpsio forks a new process to load that device. Each new process remains as an 
active process to reload the device in the event of a power failure or a fatal error 
such as a bus error, unexpected interrupt, or memory parity error. 


Idhpsio does not fork a new process if the device is not found, if the installed 
operating system does not support the device, or if a previous /dhpsio is active for 
the device. 


ry FILES 


/etc/hpsio.out 
/dev/hp 


SEE ALSO 
hpsio(7) 
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NAME 
a -Idsysdump - load system dump from tape 


SYNOPSIS 
/etcfidsysdump [ -t unit_number ][ -s ] destination_file 


DESCRIPTION 
The command /dsysdump loads the memory image files from the tape used to 
take a system dump and recombines them into a single file on the hard disk 
suitable for use by crash(1). The destination _file is the name of the hard disk file 
into which the data from tapes are loaded. /dsysdump invokes dd to load in the 
memory image with the command 


dd if= <tape_device> of=<filename> 


where: 


<tape_device> 
is the pathname of the tape, (e.g. /dev/rtp) 


< filename > 
is the destination file name on disk. 


OPTIONS 
-t unit_number 
load the system dump from tape unit unit_number. 


When invoked, /dsysdump begins an interactive procedure that prompts the user 
| to insert the tape to be loaded. 


-s Swap bytes. 


EXAMPLES 
This example loads the tape produced by using the Start-Up Subsystem (SUS) 
memory dump utility. 
$ Idsysdump -t cdump 


f \ Insert first sysdump tape. 
Enter ‘c' to continue, 'q' to quit: c 


Loading system dump 
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FILES 
/dev/rtp first tape drive (st01) 


SEE ALSO 


crash(1M) 
dd(1), ulimit(1) in the User’s Reference Manual 


Page 2 UP-14805 


LED(1M) 


NAME 
™ led - flash red LED 


SYNOPSIS 
fetc/led [ -f | -o | -d ] 


DESCRIPTION 
The command /ed is used to turn on the System Fault Indicator located on the 
front of the cabinet. The main purpose is to signal error conditions. 


This command can be run only by the superuser. 


OPTIONS : 
-f sets the indicator to a flashing state using the sys32(2) system call. 


-o sets the indicator to a constant on state using the sys32(2) system call. 


-d__ sets the indicator to a constant off state using the sys32(2) system call. 
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NAME 
link, unlink - link and unlink files and directories 


SYNOPSIS 
/etc/link file1 file2 
/etc/unlink file 


DESCRIPTION 
The link command is used to create a file name that points to another file. 
Linked files and directories can be removed by the unlink command; however, it 
is strongly recommended that the 7m(1) and rmdir(1) commands be used instead 
of the unlink command. 


The only difference between /n(1) and link/unlink is that the latter do exactly 
what they are told to do, abandoning all error checking. This is because they 
directly invoke the dink(2) and unlink(2) system calls. 


SEE ALSO 
rm(1) in the User’s Reference Manual 
link(2), unlink(2) in the Programmer’s Reference Manual 


WARNINGS 
These commands can be run only by the superuser. 
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NAME 
logalert - error log threshold analysis utility 


SYNOPSIS 
/ncerm/checklog/logalert [-f file] 


DESCRIPTION 
The command /ogalert reads each error record in the error log file and tallies the 
errors by device type, for example, tt01 or f[501. An error message is generated 
for each device that has errors equal to its threshold value. The threshold values 
are obtained from the /ncrm/checklog/threshold file. 


The -f option specifies the named file as the error log file. This file must be in 
the format specified in errfile(4). If no file is specified, /ogalert uses 
/usr/admlerrfile. 


logalert is executed automatically by cron(1M). 


OUTPUT 

/ncrm/checklog/alertmesg 
Summary file of error messages for all devices that have reached their 
threshold values. This file grows in size until it is manually removed or until 
it is copied at weekly intervals to /ncrm/checklog/oalertmesg. 

/ncrm/checklog/alert{mmddyy } 
Contains the error log records of each device that has reached its threshold 
value. This file is in the format of er7file(4) . 


FILES 
/ncrm/checklog/threshold 
/ncrm/checklog/alert{ mmddyy} 
/ncrm/checklog/alertmesg 


SEE ALSO 
cron(1M), errpt(1M) 
errfile(4), threshold(4), alertmesg(4), alert(4) in the Programmer’s Reference 
Manual 
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NAME 
lpadmin - configure the LP spooling system 


SYNOPSIS 
/usr/lib/Ipadmin -p printer [options | 
/usr/lib/padmin -x dest 
/usr/lib/padmin -d[{dest] 


DESCRIPTION 
The command /padmin configures line printer (LP) spooling systems to describe 
printers, classes and devices. It is used to add and remove destinations, change 
membership in classes, change devices for printers, change printer interface 
programs and to change the system default destination. Jpadmin may not be used 
when the LP scheduler, /psched(1M), is running, except where noted below. 


Exactly one of the -p, -d or -x options must be present for every legal invocation 
of Ipadmin. 


-pprinter names a printer to which all of the options below refer. If printer 
does not exist then it is created. 


-xdest removes destination dest from the LP system. If dest is a printer and 
is the only member of a class, then the class is deleted, too. No 
other options are allowed with -x. 


-d[dest] makes dest, an existing destination, the new system default 
destination. If dest is not supplied, then there is no system default 
destination. This option may be used when /psched(1M) is running, 
No other options are allowed with -d. 


The following options are only useful with -p and may appear in any order. For 
ease of discussion, the printer is referred to as P below. 


-cclass inserts printer P into the specified class. Class is created if it does 
not already exist. 

~-eprinter copies an existing printer’s interface program to be the new interface 
program for P. 

-h indicates that the device associated with P is hardwired. This option 
is assumed when adding a new printer unless the -I option is 
supplied. 


-iinterface establishes a new interface program for P. Interface is the pathname 
of the new program. | 
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-] indicates that the device associated with P is a login terminal. The 
LP scheduler, /psched, disables all login terminals automatically each 
time it is started. Before re-enabling P, its current device should be 
established using /padrin . 


-mynodel __ selects a model interface program for P. Model is one of the model 
interface names supplied with the LP Spooling Utilities (see the 
Models description in the following text for more information). 


-rclass removes printer P from the specified class. If P is the last member 
of the class, then the class is removed. 


-vdevice associates a new device with printer P. Device is the pathname of a 
file that is writable by jp. Note that the same device can be 
associated with more than one printer. If only the -p and -v options 
are supplied, then /padmin may be used while the scheduler is 
running. 

Restrictions 

When creating a new printer, the -v option and one of the -e, -i or -m options 

must be supplied. Only one of the -e, -i or -m options may be supplied. The -h 

and -I keyletters are mutually exclusive. Printer and class names may be no 


longer than 14 characters and must consist entirely of the characters A-Z, a-z, 0-9 
and _ (underscore). 


Models 


Model printer interface programs are supplied with the LP Spooling Utilities. 
They are shell procedures which interface between Ipsched and devices. All 
models reside in the directory /usr/spool/Ip/model and may be used as is with 
ipadmin -m. Copies of model interface programs may also be modified and then 
associated with printers using Jpadmin -i. The following describes the models 
which may be given on the /p command line using the -o keyletter: 


LQP-40 
Letter quality printer using XON/XOFF protocol at 9600 baud. 
DQP-10 
Dot matrix draft quality printer using XON/XOFF protocol at 9600 baud. 


EXAMPLES 


1. For a DQP-10 printer named cI8, it uses the DOP-10 model interface after 
the command: 


/usr/lib/lpadmin -pcI8 -mdqp10 
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A LOQP-40 printer called pri can be added to the Ip configuration with the 


pz 
ec” command: 


/usr/lib/lpadmin -ppr1 -v/dev/contty -mlqp40 


FILES 
/usr/spool/lp/* 


SEE ALSO 


accept(1M), Ipsched(1M) 
enable(1), lp(1), Ipstat(1) in the User’s Reference Manual 
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NAME 
Ipsched, Ipshut, lpmove - start/stop the LP scheduler and move requests 


SYNOPSIS 
/usr/lib/lpsched 
/usr/lib/lpshut 
/usr/lib/Ipmove requests dest 
/usr/lib/Ipmove dest1 dest2 


DESCRIPTION 
The command Ipsched schedules requests taken by /p(1) for printing on line 
printers (LP’s). 


Ipshut shuts down the line printer scheduler. All printers stop printing at the 
time /pshut is invoked. Requests printing when a printer is shut down are 
reprinted in their entirety after /psched is started again. 


Ipmove moves requests that were queued by /p(1) between LP destinations. This 
command may be used only when Jpsched is not running. 


The first form of the command moves the named requests to the LP destination, 
dest. Requests are request IDs as returned by /p(1). The second form moves all 
requests for destination dest1 to destination dest2. As a side effect, fp (1) rejects 
requests for dest. 


Note that Jpmove never checks the acceptance status [see accept(1M)] for the 
new destination when moving requests. 


FILES 
/usr/spool/|p/* 


SEE ALSO 


accept(1M), Ipadmin(1M) 
enable(1), Ip(1), Ipstat(1) in the User’s Reference Manual 


UP-14805 Page 1 


LPSCHED (1M) 


—_— eee 


[This page left blank.] 


Page 2 UP-14805 


LPSET(1M) 


NAME 
Ipset - set parallel line printer options 


SYNOPSIS 
Ipset [control options] [mode options] 


DESCRIPTION 
The /pset command sets the page control and translation options for the parallel 
printer interface. The /pset command offers control options and mode options. 
With no options, /pset reports the current settings. The printer is specified by 
standard in, e.g. /pset -c 80 < /dev/pp00. 


Control options, accepted as decimal numbers, follow: 


-i indent Sets the indent, in characters. The default is 4. 
-I lines Sets the lines per page. The default is 66. 
-c columns Sets the number of columns per page. The default is 132. 


The mode options set various options available, as follows: 


bs | nobs 
Specifies backspace or no backspace. The default is backspace (bs). 


raw | canon 
Specifies raw or canonical output. The default is canonical (canon). 


cap ; allcase 
Specifies uppercase characters only or a mix of uppercase and lowercase 
characters. The default is uppercase and lowercase mixed (allcase). 


cr | nocr 
Specifies carriage return or no carriage return. The default is carriage 
return (cr). | 
ff | noff 


Specifies form feed or no form feed. The default is form feed (ff). 


ni | nonl 
Specifies newline or no newline. The default is newline (nl). 


form | noform 
Specifies whether or not to send a form feed to the printer when device is 
closed. The default is form. 


For more detailed explanations on the options, see /p(7). 
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FILES 
/dev/pp?? 
/etc/rc2.d/SXXI1p initialization for /p or pr spooling system 


SEE ALSO 
Ip(7) 


DIAGNOSTICS 
Self explanatory, except that "parallel printer not properly connected" can actually 
mean that the printer is in use. 
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NAME 
rr mkfs, mkfs4k, mkfs512 - construct a file system 


SYNOPSIS 
/ete/mkfs special blocks [:i-nodes] [gap blocks/cyl] 
/ete/mkfs special proto [gap blocks/cyl] 
/ete/mkfs4k special blocks [:i-nodes] [gap blocks/cyl] 
/etc/mkfs4k special proto [gap blocks/cyl] 
/ete/mkfs512 special blocks [:i-nodes] [gap blocks/cyl] 
/etc/mkfs512 special proto [gap blocks/cyl] 


DESCRIPTION 
The command mkfs constructs a file system of 1024 byte blocks by writing on the 
special file according to the directions found in the remainder of the command 
line. 
mkfs4k constructs a file system of 4K byte blocks by writing on the special file 
according to the directions found in the remainder of the command line. 


™ mkfs512 constructs a file system of 512 byte blocks by writing on the special file 
according to the directions found in the remainder of command line. File 
systems with 512 byte blocks are only needed for transporting files to systems 
running earlier versions of the operating system or for file systems where the 
majority of files are less than 512 bytes in length. 


It is recommended to use newfs(1M) to construct a file system. 


mkfs waits 10 seconds before starting to construct the file system. During this 10 
second pause, the command can be stopped by entering a delete (DEL). 


The way the file system is constructed depends on the second argument, which 
may specify either the number blocks or a prototype file. 


Number of blocks 

If the second argument is given as a string of digits, mkfs builds a file system with 
| a single empty directory on it. The size of the file system is the value of blocks 
| interpreted as a decimal number. This is the number of physical disk blocks the 
file system contains. The boot program is left uninitialized. 


If the optional number of i-nodes is not given, the default is the number of logical 
| blocks divided by 4. 


Prototype file 
If the second argument is a file name that can be opened, mkfs assumes it to be a 
prototype file proto, and takes its directions from that file. 
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The prototype file contains tokens separated by spaces or newlines. 


The first token is the name of a file to be copied onto block zero as the bootstrap ] 
program. 


The second token is a number specifying the size of the created file system in 
physical disk blocks. Typically it is the number of blocks on the device, perhaps 
diminished by space for swapping. 


The next token is the number of i-nodes in the file system. The maximum 
number of i-nodes configurable is 65500. 


Omit the second and third tokens (i.e. the number of physical disk blocks and i- 
nodes) if the prototype file is being created for use with newfs(1M). In this case, 
these values are determined for you. 


The next set of tokens comprises the specification for the root file. File 
specifications consist of tokens giving the mode, the user ID, the group ID, and 
the initial contents of the file. The syntax of the contents field depends on the 
mode. The mode token for a file is a 6 character string. 


- The first character specifies the type of the file. The characters -bed specify 
regular, block special, character special and directory files respectively. 


- The second character of the type is either u or - to specify set-user-ID mode 
or not. 


- The third is g or - for the set-group-ID mode. 


- The rest of the mode is a three digit octal number giving the owner, group, 
and other read, write, execute permissions [see chmod (1)]. 


Two decimal number tokens come after the mode; they specify the user and 
group IDs of the owner of the file. 


If the file is a regular file, the next token is a pathname whence the contents and 
size are copied. If the file is a block or character special file, two decimal 
number tokens follow which give the major and minor device numbers. If the file 
is a directory, mkfs makes the entries . and .. and then reads a list of names and 
(recursively) file specifications for the entries in the directory. 


The scan is terminated with the token $. 
A sample prototype specification follows: 


/dev/null 
4872 110 
d--777 31 
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usr = d--777 3.1 
mm | sh —----755 3.1 /bin/sh 
ken d--75561 
$ 


b0 b--6443 100 
co) c--6443 100 
$ 

$ 


Line 1 in the example is the name of the file to be copied onto block zero as the 
bootstrap program. 


Line 2 specifies the number of physical blocks the file system is to occupy and the 
number of i-nodes in the file system. 


Lines 3 through 9 define the files and directories that are to be included in this 
file system. 


-Line 3 specifies the root directory. 
o™ Lines 4 through 6 and 8 through 9 specify other directories and files. 


The $ on line 7 indicates to mkfs to end the branch of the file system it is on, and 
continue from the next higher directory. The $ on lines 10 and 11 end the 
process, because no additional specifications follow. 


File specifications give the mode, the user ID, the group ID, and the initial 
contents of the file. Valid syntax for the contents field depends on the first 
character of the mode. 


Gap and blocks/cyl 
In both command syntaxes, the rotational gap and the number of blocks/cyl can 
be specified. The following values are recommended: 


Bik/Cy 


5.25" Winchester 10 119 
3 16 
7 400 


Floppy 
Default 

rf The default is used if the supplied gap and blocks/cyl are considered invalid 

| values or if a short argument count occurs. 
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SEE ALSO 
newfs(1M) 
chmod(1) in the User’s Reference Manual 
dir(4), fs(4) in the Programmer’s Reference Manual 


RESTRICTIONS 
If a prototype is used, it is not possible to initialize a file larger than 64K bytes, 
nor is there a way to specify links. 
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NAME 
mklanginfo - generate language-dependent information 


SYNOPSIS 
mklanginfo [file] 


DESCRIPTION 
The utility mklanginfo takes as an argument a file containing the specification of 
the language-dependent information for a particular locale and builds an output 
file which is used at run time to provide the data to an application. If no file is 
given, the standard input is used. The output is written in the file file.out. If file 
is not supplied and standard input is used, the output is sent to the standard 
output. 


The output file once installed as /lib/locale/locale_name/ LANGINFO is accessed 
at run time by the n/_langinfo(3X) functions to retrieve the data. The format of 
the input file is a series of assignments of the form 


a ~— i di 


where X is the name of an n/_langinfo(3X) data item (see langinfo(5)) and Y is its 
value. The value Y is always enclosed in quotes. Any blank lines or lines 
beginning with a pound sign character (#) are ignored. A report on the 
assignments made is written to the standard error. 


EXAMPLES 
# 
# Cultural and Language Data for the U.S. 
# 


DAY _1="Sunday’ 
DAY 2="Monday" 
DAY 3="Tuesday’" 
DAY 4="Wednesday" 
DAY _5="Thursday" 
DAY_6="Friday" 
DAY_7="Saturday' 


ABDAY 1="Sun" 
ABDAY 2="Mon" 
ABDAY 3="Tue" 
ABDAY 4="Wed" 
ABDAY _5="Thu" 
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ABDAY 6='"Fri" 
ABDAY _7="Sat" 


MON _1="January" 
MON _2='"February" 
MON _3="March" 
MON _4="April" 

MON _5="May" 

MON _6="June" 
MON_7="July" 
MON 8="August" 
MON _9="September" 
MON_10="October" 
MON_11="November" 
MON_12="December" 


ABMON 1="Jan" 
ABMON 2="Feb" 
ABMON 3="Mar" 
ABMON 4="Apr" 
ABMON _5="May" 
ABMON 6="Jun" 
ABMON _7="Jul" 
ABMON 8="Aug" 
ABMON 9="Sep" 
ABMON_$_10="Oct" 
ABMON _11="Nov'" 
ABMON 12="Dec" 


RADIXCHAR = "." 
THOUSEP = "" 
YESSTR = "yes" 
NOSTR: = "H0" 
CRNCYSTR = "-$" 


D_T_FMT = "%a %b %d %H:%M:%S %Z %Y" 
EXIT STATUS 


On error, mklanginfo exits with a status of non-zero and a message is printed to 


the standard error. Otherwise, mklanginfo exits with status 0. 


SEE ALSO 


nl_langinfo(3X), nl_init(3X), strftime(3C), setlocale(3C), langinfo(5), nl_types(5) 


in the Programmer’s Reference Manual 
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NAME 
c™ mklost + found - make a lost + found directory for fsck 


SYNOPSIS 
/etc/mklost + found 


DESCRIPTION 
A directory lost +found is created in the current directory and a number of 
empty files are created therein and then removed so that there are empty slots 
for fsck(1). 


This command should be run immediately after first mounting and changing 
directory to a newly created file system. 


For small file systems, it is sufficient (and much faster) to simply make a 
lost + found directory. Up to 30 files can be recovered in it. 


SEE ALSO 


| fsck(1M) 
cy 
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NAME 
f~ -mknod - build special file 


SYNOPSIS 
/etc/mknod name b | c major minor 
/etc/mknod name p 


DESCRIPTION 
The command mknod makes a directory entry and corresponding i-node for a 
special file. 


The first argument is the name of the entry. The UNIX System convention is to 
keep such files in the /dev directory. 


In the first case, the second argument is b if the special file is block-type (disks, 
tape) or c if it is character-type (other devices). The last two arguments are 
numbers specifying the major device type and the minor device (e.g., unit, drive, 
or line number). They may be either decimal or octal. The assignment of major 
device numbers is specific to each system. The information is contained in the 

c™ system source file conf.c. You must be the superuser to use this form of the 
command. 


The second case is the form of the mknod that is used to create FIFOs (a.k.a 
named pipes). 


WARNINGS 
If mknod is used to create a device in a remote directory (Remote File Sharing), 
the major and minor device numbers are interpreted by the server. 


SEE ALSO 
mknod(2) in the Programmer’s Reference Manual 
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NAME 
mkunix - Configuration Manager 


SYNOPSIS 
mkunix -s systemfile -c config dir 


DESCRIPTION 
The command mkunix manages the creation of an operating system kernel. A 
complete description of the configuration process, and the role of mkunix in that 
process, is given in the Administration Guide. 


OPTIONS 
-s systernfile 
Name of the system file. 


-c config dir 
Pathname of the configuration directory. 


SEE ALSO 
config(1M) 


DIAGNOSTICS 
Diagnostics are displayed on standard output and are seif-explanatory. 
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NAME 
~~ mount, umount - mount and unmount file systems and remote resources 


SYNOPSIS 
/etc/mount [[-r] [-f fstyp] special directory] 
/etc/mount [[-r] [-c] [-d] resource directory] 
/etc/umount special 
/etc/umount [-d] resource 


DESCRIPTION 
File systems other than root (/ ) are considered removable in the sense that they 
can be either available to users or unavailable. mount announces to the system 
that special, a block special device or resource, a remote resource, is available to 
users from the mount point directory. directory must exist already; it becomes the 
name of the root of the newly mounted special. 


mount, when entered with arguments, adds an entry to the table of mounted 

devices, /etc/mnttab. umount removes the entry. If invoked with no arguments, 

mount prints the entire mount table. If invoked with an incomplete argument list, 
c™ mount searches /etc/fstab for the missing arguments. 


The following options are available: 


-r indicates that special or resource is to be mounted read-only. If 
special or resource is write-protected, this flag must be used. 


| -C indicates that remote reads and writes should not be cached in the 
local buffer pool. Use -d in conjunction with -c. 


-d indicates that resource is a remote resource that is to be mounted on 
directory or unmounted. To mount a remote resource, Remote File 

| Sharing must be up and running and the resource must be advertised 

| by a remote computer [see 7fstart(1M) and adv(1M)]. If -d is not 

| used, special must be a local block special device. 


-f fstyp indicates that fstyp is the file system type to be mounted. If this 
argument is omitted, it defaults to the root fstyp. 


special indicates the block special device that is to be mounted on directory. 


resource __ indicates the remote resource name that is to be mounted on a 
directory. 


directory indicates the directory mount point for special or resource. (The 
directory must already exist.) 
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umount announces to the system that the file system previously mounted special 
or resource is to be made unavailable. If invoked with an incomplete argument : 
list, urnount searches /etc/fstab for the missing arguments. WS 


mount can be used by any user to list mounted file systems and resources. Only 
a superuser can mount and unmount file systems. 


FILES 
/etc/mnttab mount table 
/etc/fstab file system table 


SEE ALSO 
adv(1M), fuser(1M), rfstart(1M), setmnt(1M), unadv(1M) 
mount(2), umount(2), fstab(4), mnttab(4) in the Programmer’s Reference Manual 
"Remote File Sharing" chapter, Administration Guide for guidelines when 
mounting remote resources. 


DIAGNOSTICS 
If the mount(2) system call fails, mount prints an appropriate diagnostic. mount 
issues a warning if the file system to be mounted is currently mounted under 
another name. A remote resource mount fails if the resource is not available or 
if Remote File Sharing is not running. 


umount fails if special or resource is not mounted or if it is busy. special or 
resource is busy if it contains an open file or some user’s working directory. In 
such a case, you can use fuser(1M) to list and kill processes that are using special 
or resource. 


WARNINGS 
Physically removing a mounted file system diskette from the diskette drive before 
issuing the umount command damages the file system. 
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NAME 
~~ -mountall, umountall - mount, unmount multiple file systems 


SYNOPSIS 
/etc/mountall [-]  [file-system-table] 
/etc/umountall [ -k ] 


DESCRIPTION 
These commands may be executed only by the superuser. 


mountall is used to mount file systems according to a file-systern-table. (/etc/fstab 
is the default file system table.) The special file name "-" reads from the standard 
input. 


Before each file system is mounted, it is checked using fsstat(1M) to see if it 
appears mountable. If the file system does not appear mountable, it is checked, 
using fsck(1M), before the mount is attempted. 


umountall causes all mounted file systems except root to be unmounted. The -k 
option sends a SIGKILL signal, using fuser(1M), to processes that have files 


i | open. 


FILES 
File-system-table format: 


column 1 block special file name of file system 
column 2 mount-point directory 
column 3 "-r" if to be mounted read-only; "-d" if remote 


column 4 (optional) file system type string 


column 5+ ignored 


White-space separates columns. Lines beginning with "#" are comments. Empty 
lines are ignored. 


~~ A typical file-system-table might read: 
/dev/dsk/cld0s2—/usr -r S51K 
SEE ALSO 
fsck(1M), fsstat(1M), fuser(1M), mount(1M) 
signal(2), fstab(4) in the Programmer’s Reference Manual 
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DIAGNOSTICS 
No messages are printed if the file systems are mountable and clean. 


Error and warning messages come from fsck(1M), fsstat(1M), and mount(1M). UO 
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“™ NAME 
| multi - go from single-user to multi-user mode 


SYNOPSIS 
/etc/multi 


DESCRIPTION 
The script multi is a shell script program which may be invoked by the superuser 
from any login device to return the system from single-user mode to multi-user 
mode. 


After it is invoked, multi displays the message: 


Press the <Return> key to continue, enter "x" to cancel: <.> 


When the login prompt appears on the system console, you may log in to the 
system. 


SEE ALSO 
rf" init(1M) 
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NAME 
mvdir - move a directory 


SYNOPSIS 
/etc/mvdir dirname name 


DESCRIPTION 
The command mvdir moves directories within a file system. dimame must be a 
directory. If name does not exist, it is created as a directory. If name does exist, 
dimame is created as name/dimame. dimame and name may not be on the same 
path; that is, one may not be subordinate to the other. For example: 


mvdir x/y x/Z 
is legal, but 
mvdir x/y x/y/z 
is not. 
SEE ALSO 


mkdir(1), mv(1) in the User’s Reference Manual 


WARNINGS 
Only the superuser can use mvdir. 
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NAME 
ncheck - generate pathnames from i-numbers 


SYNOPSIS 
/etc/ncheck [ -i i-numbers ] [ -a ] [ -s ]_ [ file-system ] 


DESCRIPTION 
The command ncheck with no arguments generates a pathname vs. i-number list 
of all files on a set of default file systems (see /etc/checklist). Names of directory 
files are followed by /.. 


The options are as follows: 
-i__ limits the report to only those files whose i-numbers follow. 
-a__ allows printing of the names . and .., which are ordinarily suppressed. 


-s limits the report to special files and files with set-user-ID mode. This 
option may be used to detect violations of security policy. 


file-system must be specified by the file system’s special file. 
The report should be sorted so that it is more useful. 


SEE ALSO 


fsck(1M) 
sort(1) in the User’s Reference Manual 


DIAGNOSTICS 
If the file system structure is not consistent, ?? denotes the "parent" of a 
parentless file and a pathname beginning with ... denotes a loop. 
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NAME 
newfs - construct a file system 


SYNOPSIS 
/etc/newfs [ -v ] [ -f filesystem ] [ -s partition ] [ -b blocks -i inodes -g gap 
-p proto ] disk-name 


DESCRIPTION 
The command newfs is a front-end to the mkfs(1M) program. newfs determines 
the type of disk a file system is being created on, calculates the appropriate 
parameters to use in calling mkfs, and builds the file system by forking mkfs. 


OPTIONS 

-v Verbose. Display any messages. 

-§ partition 
The partition number to use for the file system. 

disk-name 
The disk-name specifies the pathname associated with a particular disk 
partition; for example /dev/rdsk/0s1. If the disk is the root disk, partition 0 
cannot be used. 


Options which may be used to override default parameters passed to mkfs are: 


-b blocks 
The number of 512 byte blocks in the file system. 

-i inodes 
The number of inodes desired for the file system. The default is the number 
of logical blocks divided by 4 for a 512 byte block and a 1K byte block file 
system, or by 2 for a 4K byte block file system. 

“8 Sap 
The physical gap between file system blocks. 

-p proto 
The prototype file. Warning: newfs edits the input prototype file for the 
number of physical disk blocks and inodes. See mkfs(1M). 

-f filesystem | 
Define the file system block size in bytes. Possible values for filesystern are 
512, 1024 (1K file system, default), and 4096 (4K file system). 


SEE ALSO 
mkfs(1M), format(1M) 
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RESTRICTIONS 


fsck must be performed on new file systems before the file systems are mounted 
for writing. 
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NAME 
nlsadmin - network listener service administration 


SYNOPSIS 
nisadmin -x 
nisadmin [ options ] net_spec 


DESCRIPTION 
The command nlsadmin administers the network listener process(es) on a 
machine. Each network has a separate instance of the network listener process 
associated with it; each instance (and thus, each network) is configured 
separately. The listener process "listens" to the network for service requests, 
accepts requests when they arrive, and spawns servers in response to those 
service requests. The network listener process works with any network (more 
precisely, with any transport provider) that conforms to the transport provider 
specification. 


The listener supports two classes of service: a general listener service, serving 
processes on remote machines, and a terminal login service, for terminals 
connected directly to a network. The terminal login service provides networked 
access to this machine in a form suitable for terminals connected directly to the 
network. However, this direct terminal service requires special associated 
software, and is only available with some networks (for example, Ethernet). 


nlsadmin can establish a listener process for a given network, configure the 
specific attributes of that listener, and start and kill the listener process for that 
network. nlsadmin can also report on the listener processes on a machine, either 
individually (per network) or collectively. 


The following list shows how to use nlsadmin. In this list, net_spec is a particular 
listener process. Specifically, net_spec is the relative pathname of the entry under 
/dev for a given network (that is, a transport provider). Changing the list of 
services provided by the listener produces immediate changes, while changing an 
address on which the listener listens has no effect until the listener is restarted. 
The following combination of options can be used. 


nisadmin gives a brief usage message. 
nisadmin -x reports the status of all the listener processes installed on 
this machine. 


nlsadmin net spec _ prints the status of the listener process for net_spec. 


nlsadmin -q net_spec queries the status of the listener process for the specified 
network, and reflects the result of that query in its exit 
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nisadmin -v net_spec 


code. Ifa listener process is active, nlsadmin exits with a 
status of 0; if no process is active, the exit code is 1; while + 
the exit code is greater than 1 in case of error. 


prints a verbose report on the servers associated with 
net_spec, giving the service code, status, command, and 
comment for each. 


nlsadmin -z code net_spec 


prints a report on the server associated with net spec that 
has service code code, giving the same information as in the 
-V option. 


nlsadmin -q -z code net_spec 


queries the status of the service with service code code on 
network net_spec, and exits with a status of 0 if that service 
is enabled, 1 if that service is disabled, and greater than 1 
in case of error. 


nlsadmin -l addr net_spec 


changes or sets the address on which the listener listens a 
(the general listener service). This is the address generally 
used by remote processes to access the servers available 
through this listener (see the -a option, below). addr is the 
transport address on which to listen and is interpreted 
using a syntax that allows for a variety of address formats. 
By default addr is interpreted as the symbolic ASCII 
representation of the transport address. An addr preceded 
by a \x lets you enter an address in hexadecimal notation. 
Note that addr must appear as a single word to the shell 
and must be quoted if it contains any blanks. 


If addr is just a dash ("="), nlsadmin reports the address 
currently configured, instead of changing it. 


A change of address does not take effect until the next 
time the listener for that network is started. 


-_— 


nlsadmin -t addr net_spec 
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changes or sets the address on which the listener listens for WwW 
requests for terminal service, but is otherwise similar to the 

-I option above. A terminal service address should not be 

defined unless the appropriate remote login software is 
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available; if such software is available, it must be configured 
as service code 1 (see the -a option, below). 


initializes or changes a listener process for the network 
specified by net_spec, that is, it creates and initializes the 
files required by the listener. Note that the listener should 
only be initialized once for a given network, and that doing 
so does not actually invoke the listener for that network. 
The listener must be initialized before assigning addressing 
Or Services. 


nlsadmin [-m] -a service_code [-p modules] -c cmd -y comment net_spec 


UP-14805 


adds a new service to the list of services available through 
the indicated listener. service_code is the code for the 
service, cmd is the command to be invoked in response to 
that service code, comprised of the full pathname of the 
server and its arguments, and comment is a brief (free- 
form) description of the service for use in various reports. 
Note that cmd must appear as a single word to the shell 
and must be quoted if it contains arguments for the server. 
Similarly, the comment must also appear as a single word 
to the shell. When a service is added, it is initially enabled 
(see the -e and -d options, below). 


If the -m option is specified, the entry is marked as an 
administrative entry. Service codes 1 through 100 are 
reserved for administrative entries, which are those that 
require special handling internally. In particular, code 1 is 
assigned to the remote login service, which is the service 
automatically invoked for connections to the terminal login 
address. 


If the -p option is specified, then modules are interpreted 
as a list of STREAMS modules for the listener to push 
before starting the service being added. The modules are 
pushed in the order they are specified. modules should be 
a comma-separated list of modules, with no white space 
included. This option is only available with UNIX System 
V Release 3.0. 


A service must explicitly be added to the listener for each 
network on which that service is to be available. This 
operation is normally performed only when the service is 
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installed on a machine, or when populating the list of 
services for a new network. 


nilsadmin -r service_code net_spec 
removes the entry for the service_code from that listener’s 
list of services. This is normally performed only in 
conjunction with the de-installation of a service from a 
machine. 


nisadmin -e service_code net_spec 

nisadmin -d service_code net_spec 
enables or disables (respectively) the service indicated by 
service_code for the specified network. The service must 
have previously been added to the listener for that network 
(see the -a option, above). Disabling a service causes 
subsequent service requests for that service to be denied, 
but the processes from any prior service requests that are 
still running continue unaffected. 


nisadmin -s net_spec 

nlsadmin -k net_spec starts and kills (respectively) the listener process for the 
indicated network. These operations are normally 
performed as part of the system startup and shutdown 
procedures. Before a listener can be started for a 
particular network, it must first have been initialized, and 
an address must be defined for the general listener service 
(see the -i and -1 options, above). When a listener is killed, 
processes that are still running as a result of prior service 
requests continue unaffected. 


The listener runs under its own ID of listen, with group ID adm. This ID must 
be entered in the system password file /etc/passwd; the HOME directory listed 
for that ID is concatenated with net_spec to determine the location of the listener 
configuration information for each network. 


nisadmin may be invoked by any user to generate reports, but all operations that 
affect a listener’s status or configuration are restricted to the superuser. 


FILES 
/usr/net/nls/net_spec 


SEE ALSO 
Network Programmer’s Guide 
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NAME 


nodes - returns information concerning specified disk or tape device 


SYNOPSIS 
/etc/nodes SUS_name | -d pathname 


DESCRIPTION 
The command nodes returns useful information concerning a specified disk or 
tape device. The device can be identified by either a SUS name (e.g. h501) or a 
pathname (e.g. /dev/rdsk/1s1). 


The information fields that are returned have the format 


fld 1 fld 2 fld 3 fld_4 fld_5 fild_6 fld_7 fld_8 fld_9 


where: 


fld_ 1 
fld 2 


fld 3 
fld 4 


fld 5 
fld 6 
fld_7 


fld 8 
fld 9 
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defines the device SUS name. This field is not displayed if the SUS_name 
argument is specified. 


defines the block device major number if a disk device is specified or the 
device number if a tape device is specified. 


defines the character device major number. 


defines the minor number for partition 0 if a disk device is specified or the 
minor number for yy node if a tape device is specified. 


defines the minor number for partition 1 if a disk device is specified or the 
minor number for yn node if a tape device is specified. 


defines the swap minor number if a disk device is specified or the minor 
number for ny node if a tape device is specified. 


is not used if a disk device is specified. Defines the minor number for nn 
node if a tape device is specified. 


is not used. 


is not used. 
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NAME 
f nsquery - Remote File Sharing name server query 


SYNOPSIS 
nsquery [-h] [name] 


DESCRIPTION 
The command nsquery provides information about resources available to the host 
from both the local domain and from other domains. All resources are reported, 
regardless of whether the host is authorized to access them. When used with no 
options, nsquery identifies all resources in the domain that have been advertised 
as sharable. A report on selected resources can be obtained by specifying name, 
where name 1s: 


nodename The report includes only those resources available from 
nodename. 
domain. The report includes only those resources available from 
domain. 
| ) domain.nodename_ The report includes only those resources available from 


domain.nodename. 


When the name does not include the delimiter ".", it is interpreted as a nodename 
within the local domain. If the name ends with a delimiter ".", it is interpreted as 
a domain name. 


The information contained in the report on each resource includes its advertised 
name (domain.resource), the read/write permissions, the server 
(nodename.domain) that advertised the resource, and a brief textual description. 


When -A is used, the header is not printed. 


A remote domain must be listed in your rfmaster file in order to query that 
domain. 


EXIT STATUS 
If no entries are found when nsquery is executed, the report header is printed. 


> ERRORS 


If your host cannot contact the domain name server, an error message is sent to 
standard error. 
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SEE ALSO 
adv(1M), unadv(1M) 
rfmaster(4) in the Programmer’s Reference Manual 
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NAME 
partcopy - copy a part of a file system 


SYNOPSIS 
partcopy [options] source_fs source _dev source_vol dest_fs dest_dev dest_vol 


DESCRIPTION 
The command partcopy makes a literal copy of a file system or a portion of a file 
system from a specified disk to a specified tape, or restores a previously copied 
file system from tape to disk. Tapes created with partcopy are compatible with 
volcopy(1M) and frec(1M). partcopy creates its own tape label which minimizes 
tape handling when doing multiple tape backups. 


Source_fs indicates the name of the source file system where the original data 
being copied can be located. Source_dev indicates the device name which 
contains the file system being copied. Source_vol indicates the volume identifier 
(ID) of the file system being copied. 


Dest_fs indicates the name of the destination file system where the data is to be 
copied. Dest_dev indicates the device name which contains the destination file 
system. Dest vol indicates the volume identifier (ID) of the destination file 
system. 


partcopy only transfers the amount of data specified from the source_dev device 
to the dest_dev device. The user must provide the correct parameters to permit 
various tape lengths and device types. 


The source_fs, source_dev, source_vol, dest_fs, dest_dev, and dest_vol, fields are 
position sensitive. They must be entered in their respective order. If a field is 
omitted, a hyphen (-) must be entered in place of the field. 


OPTIONS 
-bpi density The tape density (in bits per inch) is saved in the tape label. 
-feet size The length of the tape (in feet) is saved in the tape label. 
-reel num The reel number for this tape. 


-capacity blocks Tape cartridge capacity in blocks. 
-bufsz bytes What transfer buffer size should be used. 
-mnt mntname The mounted name of the file system is saved in the tape label. 


-msum filename Write the checksum value into this file name. 
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The -bpi and -feet options are provided for convenience only. They record their 
information in the tape label and do not have any impact on the amount of data | 
stored on the tape cartridge. WwW 


partcopy produces a single tape for each invocation. When multiple tapes are 
required for a large file system, then multiple calls to partcopy are necessary. All 
tapes associated with a particular file system must be the same capacity. The 
-reel option is used to indicate which tape is currently being produced. When 
restoring from tape to disk, the user is not notified when additional tapes are 
required. 


When copying from tape to disk the source_fs and source_vol must match the 
tape label exactly. 


The -bufsz option is provided to optimize the transfer block size. 


The mounted pathname of the file system may be saved on the tape. The 
mntname, specified with the -mnt option, is truncated to 32 characters and saved 
in the tape label. 


partcopy always calculates a checksum value. The value is saved in the /tmp/vsum , 
file unless an alternate file name is specified using the -msuwm option. / 


SEE ALSO 
frec(1M), labelit(1M), volcopy(1M) 


EXAMPLES 
partcopy -capacity 85425 - /dev/rdsk/Os1 - 0s1 /dew/rstp/Oyy 113 


Copy the file system from disk /dev/rdsk/Os1 to tape /dev/rstp/Oyy. The tape is 
being labeled as fsname 0s1 and volume 113. 


partcopy Os1 /dev/rstp/Oyy 113 1s1 /dev/rdsk/1s1 - 


Copy the contents of the tape to the disk /dev/rdsk/Is1. The tape is specified as 
fsname 0s1 and volume 113. The file system on the disk is renamed 1s]. 
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NAME 


profiler: prfld, prfstat, prfdc, prfsnap, prfpr - UNIX system profiler 


SYNOPSIS 


/etc/prfld [ system_namelist ] 

/etc/prfstat on 

/etc/prfstat off 

/etc/prfde file [ period [ off_hour ] ] 
/etc/prfsnap file 

/ete/prfpr file [ cutoff [ system_namelist ] ] 


DESCRIPTION 


The programs prfld, prfstat, prfdc, prfsnap, and prfpr form a system of programs 
to facilitate an activity study of the UNIX operating system. 


prfid is used to initialize the recording mechanism in the system. It generates a 
table containing the starting address of each system subroutine as extracted from 
system_namelist. 


prfstat is used to enable or disable the sampling mechanism. Profiler overhead is 
less than 1% as calculated for 500 text addresses. prfstat also reveals the number 
of text addresses being measured. 


prfdc and prfsnap perform the data collection function of the profiler by copying 
the current value of all the text address counters to a file where the data can be 
analyzed. prfdc stores the counters into file every period minutes and turns off at 
off hour (valid values for off hour are 0-24). prfsnap collects data at the time of 
invocation only, appending the counter values to file. 


prfpr formats the data collected by prfdc or prfsnap. Each text address is 
converted to the nearest text symbol (as found in system_namelist) and is printed 
if the percent activity for that range is greater than cutoff. 


FILES 


/dev/prf interface to profile data and text addresses 
/unix default for system namelist file 
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NAME 
pwcek, grpck - password/group file checkers 


SYNOPSIS 
/etc/pwek [file] 
/etc/grpek [file] 


DESCRIPTION 
The command pwck scans the password file and notes any inconsistencies. The 
checks include validation of the number of fields, login name, user ID, group ID, 
and whether the login directory and the program-to-use-as-Shell exist. The 
default password file is /etc/passwd. 


erpck verifies all entries in the group file. This verification includes a check of the 
number of fields, group name, group ID, and whether all login names appear in 
the password file. The default group file is /etc/group. 


FILES 
/etc/group 
/etc/passwd 


SEE ALSO 
group(4), passwd(4) in the Programmer’s Reference Manual 


DIAGNOSTICS 
Group entries in /etc/group with no login names are flagged. 
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NAME 
4 \ pwrcycle - set system power up time and immediately power down system 


- SYNOPSIS 
/etc/pwrcycle mmddhhmmyy 


DESCRIPTION 
The command pwrcycle uses syspwr(2), to set the automatic system power up time 
to the date specified, and then immediately power down the system. A power fail 
recovery takes place with the recovery delayed until the time specified, if the 
AUTO LOAD/MANUAL switch is in auto mode. The system powers up in the 
state in which it went down (either single or multi-user). If the AUTO 
LOAD/MANUAL switch is in manual mode, the system powers up as if a 
manual reset occurred. 


Because of the immediate power down, it is recommended that system activity be 
at a minimum prior to performing this operation in order to avoid file system 
corruption. An override of a previous power up time setting is available by 
a flipping the power switch. 
The date string, mmddhhmmyy, must be specified at least five minutes ahead of 
the current date but no more than one year beyond. The first mm is the month 
number; dd is the day number in the month; Ah is the hour number (24 hour 
system); the second mm is the minute number; yy is the last two digits of the year 
number. 


RESTRICTIONS 
Available on PMC IV systems with appropriate back panel. 


SEE ALSO 
syspwr(2) in the Programmer’s Reference Manual 
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NAME 
rcO - run commands performed for single-user environment 


SYNOPSIS 
/etc/rcO 


DESCRIPTION 
This file is executed through an entry in /etc/inittab and is responsible for those 
initializations that bring the system to a single-user state. 


The actions performed by /etc/rc0 are found in files beginning with K in /etc/rc0.d. 
These files are executed by /bin/sh in s-1LASCII sort-sequence order (see FILES 
for more information). When functions are added that need to be initialized or 
when the system goes single-user, an appropriate file should be added in 
/etc/rc0.d. 


The functions done by /efc/rcO command and associated /etc/rc0.d files include: 
Shut down the LP spooler. 
Unmount all non-root partitions and remote file resources. 
Stop the errdemon and remote file sharing start daemon if they are running. 
Kill all processes associated with non-single-user states. 


Other functions can be added, as required, to support the addition of hardware 
and software features. 


EXAMPLES 
The following are prototypical files found in /etc/rc0.d. These files are prefixed 
by a K and a number indicating the execution order of the files. 


KlI0umount 
# umount filesystems in /ect/fstab when going 
# from multi-user to single-user 


set ‘ who -r * 
if [$9 = "S"] 
then 

exit 
fi 
syNc;sync;sync 
/etc/urnountall 
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FILES 
Here are some hints about files in /etc/rc[ 0136 ].d: 


The order in which files are executed is important. Since they are executed in WwW 
ascii sort-sequence order, using the first character of the file name as a sequence 

indicator helps keep the proper order. Thus, files starting with the following 

characters would be: 


[0-9]. very early 


[A-Z]. early 
[a-n]. later 
[o-z]. last 


Files in /etc/rc0.d must begin with an S or a K followed by a number and the rest 
of the file name. Upon entering run level 0, files beginning with S are executed 
with the start option; files beginning with K, are executed with the stop option. 
Files beginning with other characters are ignored. 


SEE ALSO 
single(1M) 
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NAME 
a» rc2 - run commands performed for multiuser environment 


SYNOPSIS 
/etc/re2 


DESCRIPTION 7 
This file is executed using an entry in /etc/inittab and is responsible for those 
initializations that bring the system to a ready-to-use state, traditionally state 2, 
called the "multiuser" state. 


The actions performed by /etc/rc2 are found in files in the directory /ete/re.d and 
files beginning with S in /etc/rc2.d. These files are executed by /bin/sh in ASCII 
sort-sequence order (see FILES for more information). When functions are 
added that need to be initialized when the system goes multiuser, an appropriate 
file should be added in /etc/rc2.d. 


The functions done by /etc/rc2 command and associated /etc/re2.d files include: 
| er Setting and exporting the TIMEZONE variable. 
Setting-up and mounting the user (/usr) file system. 
Cleaning up (remaking) the /tmp and /usr/tmp directories. 


Loading the network interface and ports cards with program data and 
starting the associated processes. 


Starting the cron daemon by executing /etc/cron. 


Cleaning up (deleting) uucp locks status, and temporary files in the 
/usr/spool/uucp directory. 


Other functions can be added, as required, to support the addition of hardware 
and software features. 


EXAMPLES 
fr ’ The following are prototypical files found in /ete/re2.d. These files are prefixed 
; by an S and a number indicating the execution order of the files. 


MOUNTFILESYS 
# Set up and mount file systems 
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cd / 
/etc/mountall /etc/fstab 


RMTMPFILES 
# clean up /tmp 
rm -rf /tmp 
mkdir /tmp 
chmod 777 /tmp 
chgrp sys /tmp 
chown sys /tmp 


uucp 
# clean-up uucp locks, status, and temporary files 


rm -rf /usr/spool/locks/* 
The file /ete/TIMEZONE is included early in /etc/rc2, thus establishing the default 
time zone for all commands that follow. 
FILES 
Here are some hints about files in /ete/re.d: 


The order in which files are executed is important. Since they are executed in 
ASCII sort-sequence order, using the first character of the file name as a 
sequence indicator helps to keep the proper order. Thus, files starting with the 
following characters would be: 


[0-9]. very early 


[A-Z]. early 
[a-n]. later 
[o-z]. last 


Files in /etc/re.d that begin with a dot (.) are not executed. This feature can be 
used to hide files that are not to be executed for the time being without removing 
them. The command can be used only by the superuser. 


Files in /etc/re2.d must begin with an S or a K followed by a number and the rest 
of the file name. Upon entering run level 2, files beginning with S are executed 
with the start option; files beginning with K, are executed with the stop option. 
Files beginning with other characters are ignored. 


SEE ALSO 
shutdown(1M) 
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NAME 
o™ rc3 - run commands performed for Remote File Sharing environment 


SYNOPSIS 
fetce/rce3 


DESCRIPTION 
This file is executed through an entry in /etc/inittab and is responsible for those 
initializations that bring the system to a multi-user plus remote access state, 
traditionally state 3, called the remote file sharing (rfs) state. 


The actions performed by /etc/rc3 are found in files beginning with S in /efc/rc3.d. 
These files are executed by /bin/sh in ASCII sort-sequence order (see FILES for 
more information). When functions are added that need to be initialized when 
the system enters the 7fs state, an appropriate file should be added in /etc/rc3.d. 


If the system is entering the 7fs state from state ’S’ or ’0’, the actions associated 
with /etc/rc2.d files are performed, thus bringing the system to the multi-user 
state. These functions include: 


Setting and exporting the TIMEZONE variable. 
Setting-up and mounting the user (/usr) file system. 
Cleaning up (remaking) the /tmp and /usr/tmp directories. 


Loading the network interface and ports cards with program data and 
starting the associated processes. 


Starting the cron daemon by executing /etc/cron. 


Cleaning up (deleting) uucp locks status, and temporary files in the 
/usr/spool/uucp directory. 


Afterwards, functions associated with the /etc/rc3.d files are performed. These 
functions include: 


rr Starts remote file sharing facility if it has been configured. 


If the system is entering the 7fs state from state ’2’, only those functions 
associated with the /etc/rc3.d files are performed. 


Other functions can be added, as required, to support the addition of hardware 
and software features. 
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FILES 
Here are some hints about files in /etc/rc[ 02 36].d : 


The order in which files are executed is important. Since they are executed in 
ASCII sort-sequence order, using the first character of the filename as a 
sequence indicator helps keep the proper order. Thus, files starting with the 
following characters would be: 


[0-9]. very early 


[A-Z]. early 
[a-nj. _—_later 
[o-z]. last 


Files in /etc/rc3.d must begin with an S or a K followed by a number and the rest 
of the filename. Upon entering run level 3, files beginning with S are executed 
with the start option; files beginning with K, are executed with the stop option. 
Files beginning with other characters are ignored. 


SEE ALSO 
rfstart(1M), rfstop(1M), rfadmin(1M) 
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NAME 
4 \ rc6 - run commands performed to stop the operating system 


SYNOPSIS 
/etc/rc6 


DESCRIPTION 
This file is executed at the system state change that needs to have the system in 
an inactive state. It is responsible for those actions that bring the system to a 
quiescent state, traditionally called shutdown. 


The entry in /etc/inittab might read: 
rc6:6:wait: /etc/rc6 < /dev/syscon > /dev/syscon 2> &1 # Run shutdown cmds 


Some of the actions performed by /etc/rc6 are carried out by files beginning with 
K in /etc/rc6.d. These files are executed in ASCII order (see FILES below for 
more information), terminating some system service. The combination of 
commands in /efc/rc6 and files in /etc/rc6.d determines how the system is shut 


o™ down. 


The recommended sequence for /etc/rcé6 1s: 
Stop System Services and Daemons. 


Various system services (such as Local Area Network or LP Spooler) are 
sracefully terminated. 


When new services are added that should be terminated when the system is 
shut down, the appropriate files are installed in /etc/rc6.d. 


Terminate Processes 


SIGTERM signals are sent to all running processes by killall(1M). 
Processes stop themselves cleanly if sent SIGTERMs +1. 


Kill Processes 


SIGKILL signals are sent to all remaining processes; no process can resist 
| SIGKILL. 


At this point the only processes left are those associated with /etc/rc6 and 
processes 0 and 1, which are special to the operating system. 
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Unmount All File Systems 


Only the root file system (/) remains mounted. 


The entries in /etc/inittab direct what happens next. If the /etc/inittab has not 
defined any other actions to be performed, then the operating system has nothing 
to do. It should not be possible to get the system’s attention. The only thing that 
can be done is to turn off the power or possibly get the attention of a firmware 
monitor. The command can be used only by the superuser. 


FILES 


The execution by /bin/sh of any files in /etc/rc6.d occurs in ascii sort-sequence 
order. See rcl(1M) for more information. 


SEE ALSO 
killall(1M), rcO(1M), rc2(1M), shutdown(1M) 
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NAME 
reboot - reboot the system 


SYNOPSIS 
/etc/reboot -d sus name [-w #sec ] [ -p #min ] [ -n | [ -s sys_name | 
/etc/reboot -c 


DESCRIPTION 
The command reboot defines the boot device and optionally reloads the operating 
system. Through various options, the superuser may specify what device to boot 
from and which operating system file to load. 


OPTIONS 
-d sus_name 
Reboot the system from sus name. Valid Start-Up Subsystem device 
names are A501, h502, sdal, sd01, etc. 


-w #S€C 
Wait #sec seconds before rebooting. The value for #sec must be a positive 
number from 1 through 65535. 


-p #min 
Wait #min minutes before restarting system (see sys32(2) 
S32. POWERDOWN command). A shutdown is performed, the system 
waits the number of minutes specified by #min, and then performs a 
reboot. The value for #min must be a positive number from 1 through 
65535. 


“S SyS_name 
Reboot the operating system using the file sys name. If sys_name is 
omitted, the operating system file is assumed to be /unix. 


-n Perform a no verify reboot. The message Press the <Retum> key to 
continue is not displayed. 


-c Clear warm string. This causes the operating system to be completely 
reloaded. 


FILES 
/unix default operating system load file 


SEE ALSO 
sys32(2) in the Programmer’s Reference Manual 
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EXAMPLES 


reboot -d h501 -n : 


Load the operating system software from the hard disk h501 using the default file 
name /unix. The user is not prompted to press the return to continue (AUTO 
mode reboot). 


DIAGNOSTICS 
must be superuser to execute 
Only the superuser may reboot the system. 


error in drive specification 
A valid sus_name must be specified. 


minutes til powerup 
The minutes until powerup must be a positive number. 


RESTRICTIONS 
The -p option functions only on PMC IV systems. 


A pseudo login banner may appear on your terminal while the system is 
unmounting the file systems and before the system reboot message is displayed. a, 
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NAME 
c™ rfadmin - Remote File Sharing domain administration 


SYNOPSIS 
rfadmin 


rfadmin -a hostname 
rfadmin -r hostname 
rfadmin -p 

rfadmin -q 

rfadmin -o loopback 
rfadmin -o noloopback 


DESCRIPTION 
The command rfadmin is used to add and remove hosts and their associated 
authentication information from a domain/passwd file on a Remote File Sharing 
~~ (RFS) primary domain name server. It is also used to transfer domain name 
| server responsibilities from one machine to another. Used with no options, 
rfadmin returns the hostname of the current domain name server for the local 
domain. 


rfadmin can only be used to modify domain files on the primary domain name 
server (-a and -r options). If domain name server responsibilities are temporarily 
passed to a secondary domain name server, that computer can use the -p option 
to pass domain name server responsibility back to the primary. Any host can use 
rfadmin with no options to print information about the domain. The user must 
have root permissions to use the command. 


-a hostname Used to add a host to a domain that is served by this domain 
name server. hostname must be of the form 
domain.nodename. It creates an entry for hostname in the 
domain/passwd file, which has the same format as 
/etc/passwd, and prompts for an initial authentication 
password; the password prompting process conforms with 


rr that of passwd(1). 


-r hostname Used to remove a host from its domain by removing it from 
the domain/passwd file. 


-p Used to pass the domain name server responsibilities back to 
a primary or to a secondary name server. 
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-q Prints a message that tells whether or not RFS is running. 


-0 loopback Used to allow RFS operations with one computer. With 
loopback enabled, an advertised resource may be mounted in 
a different location on the same machine. 


noloopback Turns off the loopback facility. This is the default. 


ERRORS 
When used with the -a option, if hostname is not unique in the domain. 


When used with the -r option; if (1) hostrame does not exist in the domain, (2) 
hostname is defined as a domain name server; or (3) there are resources 
advertised by hostname, an error message is sent to standard error. 


When used with the -p option to change the domain name server; if there are no 
backup name servers defined for domain, an error message is sent to standard 
error. 


FILES 
/usr/nserve/auth.info/domain/passwd 
(For each domain, this file is created on the primary, should be copied to all 
secondaries, and should be copied to all hosts that want to do password 
verification of hosts in the domain.) 


SEE ALSO 
rfstart(1M), rfstop(1M), umount(1M) 
passwd(1) in the User’s Reference Manual 
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NAME 
rfpasswd - change Remote File Sharing host password 


SYNOPSIS 
rfpasswd 


DESCRIPTION 
The command rfpasswd updates the Remote File Sharing authentication 
password for a host; processing of the new password follows the same criteria as 
passwd(1). The updated password is registered at the domain name server 
(/usr/nserve/auth.info /domain/passwd) and replaces the password stored at the 
local host (/usr/nserve/loc.passwd file). 


This command is restricted to the superuser. 


NOTE: If you change your host password, make sure that hosts that validate your 
password are notified of this change. To receive the new password, hosts must 
obtain a copy of the domain/passwd file from the domain’s primary name server. 
If this is not done, attempts to mount remote resources may fail! 


ERRORS 
If (1) the old password entered from this command does not match the existing 
password for this machine, (2) the two new passwords entered from this 
command do not match, (3) the new password does not satisfy the security 
criteria in passwd(1), (4) the domain name server does not know about this 
machine, or (5) the command is not run with superuser privileges, an error 
message is sent to standard error. Also, Remote File Sharing must be running on 
your host and your domain’s primary name server. A new password cannot be 
logged if a secondary is acting as the domain name server. 


FILES 
/usr/nserve/auth.info/domain/passwd 
/usr/nserve/loc.passwd 


SEE ALSO 
passwd(1), rfstart(1M), rfadmin(1M) 
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NAME 
f~ rfstart - start Remote File Sharing 


SYNOPSIS 
rfstart [-v] [-pprimary_addr]| 


DESCRIPTION 
The command rfstart starts Remote File Sharing and defines an authentication 
level for incoming requests. (This command can only be used after the domain 
name server is set up and your computer’s domain name and network 
specification has been defined using dname(1M).) 


-V Specifies that verification of all clients is required in response to initial 
incoming mount requests. Any host not in the 
/usr/nserve/auth.info/domain/passwd file for the domain they belong to 
is not allowed to mount resources from your host. If -v is not specified, 
hosts named in domain/passwd are verified, other hosts are allowed to 
connect without verification. 


cc” -p primary_addr 
Indicates the primary domain name server for your domain. 
primary_addr must be the network address of the primary name server 
for your domain. If the -p option is not specified, the address of the 
domain name server is taken from the rfmaster file. (See rfmaster(1M) 
for a description of the valid address syntax.) 


If the host password has not been set, rfstart prompts for a password. The 
password prompting process must match the password entered for your machine 
at the primary domain name server [see rfadmin(1M)]. If you remove the 
loc.passwd file or change domains, you must reenter the password. 


Also, when rfstart is run on a domain name server, entries in the rfmaster(4) file 
are syntactically validated. 


This command is restricted to the superuser. 
ERRORS 


If syntax errors are found in validating the rfmaster(4) file, a warning describing 
| - each error is sent to standard error. 


If (1) the shared resource environment is already running, (2) there is no 
communications network, (3) the domain name server cannot be found, (4) the 
domain name server does not recognize the machine, or (5) the command is run 
without superuser privileges, an error message is sent to standard error. 
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Remote file sharing does not start if the host password in /usr/nserve/loc.passwd 
is corrupted. If you suspect this has happened, remove the file and run rfstart 
again to reenter your password. a 


NOTE: rfstart does NOT fail if your host password does not match the password 
on the domain name server. You simply receive a warning message. However, if 
you try to mount a resource from the primary or any other host that validates 
your password, the mount fails if your password does not match the one that host 
has listed for your machine. 


FILES 
/usr/nserve/rfmaster 
/usr/nserve/loc.passwd 


SEE ALSO 
adv(1M), dname(1M), mount(1M), rfadmin(1M), rfstop(1M), unadv(1M) 
rfmaster(4) in the Programmer’s Reference Manual 
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NAME 


rfstop - stop the Remote File Sharing environment 


SYNOPSIS 


{stop 


DESCRIPTION 


The command rfstop disconnects a host from the Remote File Sharing 
environment until another rfstart(1M) is executed. 


When executed on the domain name server, the domain name server 
responsibility is moved to a secondary name server as designated in the rfmaster 
file. 


This command is restricted to the superuser. 


ERRORS 


If (1) there are resources currently advertised by this host, (2) resources from this 
machine are still remotely mounted by other hosts, (3) there are still remotely 
mounted resources in the local file system tree, (4) 7fstart(1M) had not previously 
been executed, or (5) the command is not run with superuser privileges, an error 
message is sent to standard error. 


SEE ALSO 


adv(1M), mount(1M), rfadmin(1M), rfstart(1M), unadv(1M) 
rfmaster(4) in the Programmer’s Reference Manual 
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SYNOPSIS 


RFUADMIN (1M) 


™” rfuadmin - Remote File Sharing notification shell script 


rfuadmin message remote_resource [seconds] 


DESCRIPTION 
The rfuadmin administrative shell script responds to unexpected Remote File 
Sharing events, such as broken network connections and forced unmounts, picked 
up by the rfudaemon process. This command is not intended to be run directly 
from the shell. 


The response to messages received by rfudaemon can be tailored to suit the 
particular system by editing the 7fuadmin script. The following paragraphs 
describe the arguments passed to 7fuadmin and the responses. 


disconnect remote_resource 


A link to a remote resource has been cut. 7fudaemon executes 
rfuadmin, passing it the message disconnect and the name of the 
disconnected resource. 7fuadmin sends this message to all terminals 
using wall(1): 


Remote_resource has been disconnected from the system. 
Then it executes fuser(1M) to kill all processes using the resource, 


unmounts the resource [usnount(1M)] to clean up the kernel, and starts 
rmount to try to remount the resource. 


fumount remote_resource 


A remote server machine has forced an unmount of a resource a local 
machine has mounted. The processing is similar to processing for a 
disconnect. 


fuwarn remote_resource seconds 
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This message notifies sfuadmin that a resource is about to be 
unmounted. fudaemon sends this script the fuwam message, the 
resource name, and the number of seconds in which the forced 
unmount occurs. sfuadmin sends this message to all terminals: 


Remote_resource is being removed from the system in # seconds. 
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SEE ALSO 
fumount(1M), rmount(1M), rfudaemon(1M), rfstart(1M) 
wall(1) in the User’s Reference Manual 


BUGS 
The console must be on when Remote File Sharing is running. If it’s not, 
rfuadmin hangs when it tries to write to the console (wall) and recovery from 
disconnected resources does not complete. 
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NAME 
rf” rfudaemon - Remote File Sharing daemon process 


SYNOPSIS 
rfudaemon 


DESCRIPTION 
The rfudaemon command is started automatically by 7fstart(1M) and runs as a 
daemon process as long as Remote File Sharing is active. Its function is to listen 
for unexpected events, such as broken network connections and forced unmounts, 
and execute appropriate administrative procedures. 


When such an event occurs, 7fudaemon executes the administrative shell script 
rfuadmin, with arguments that identify the event. This command is not intended 
to be run from the shell. Here are the events: 


DISCONNECT 
A link to a remote resource has been cut. rfudaemon executes 
rfuadmin, with two arguments: disconnect and the name of the 

ls disconnected resource. 

FUMOUNT 
A remote server machine has forced an unmount of a resource a local 
machine has mounted. rfudaemon executes rfuadmin, with two 
arguments: fumount and the name of the disconnected resource. 

GETUMSG 
A remote user-level program has sent a message to the local 7fudaemon. 
Currently the only message sent is fuwamn, which notifies sfuadmin that 
a resource is about to be unmounted. It sends -fuadmin the fuwam, the 
resource name, and the number of seconds in which the forced 
unmount occurs. 

LASTUMSG 
The local machine wants to stop the 7fudaemon [rfstop(1M)]. This 
causes 7fudaemon to exit. 


SEE ALSO 
rfstart(1M), rfuadmin(1M) 


f™ 
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NAME 
rr rmntstat - display mounted resource information 


SYNOPSIS 
rmntstat [-h] [resource] 


DESCRIPTION 
When used with no options, rmntstat displays a list of all local Remote File 
Sharing resources that are remotely mounted, the local pathname, and the 
corresponding clients. smntstat returns the remote mount data regardless of 
whether a resource is currently advertised; this ensures that resources that have 
been unadvertised but are still remotely mounted are included in the report. 
When a resource is specified, nmntstat displays the remote mount information only 
for that resource. The -/ option causes header information to be omitted from 
the display. 


EXIT STATUS 
If no local resources are remotely mounted, rmntstat returns a successful exit 


cc” status. 


ERRORS 
If resource (1) does not physically reside on the local machine or (2) is an invalid 
resource name, an error message is sent to standard error. 


SEE ALSO 
mount(1M), fumount(1M), unadv(1M) 
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NAME 
rmount - retry remote resource mounts 


SYNOPSIS 
/etc/rmount -d[r] special directory 


DESCRIPTION 
The script rmount is an administrative shell script that tries to mount remote 
resource special on directory. If the remote mount is unsuccessful, “mount waits 60 
seconds and tries to mount the resource again. This repeats forever. The 
RETRIES =0 value in the shell script can be changed to limit the number of 
times the shell script tries to mount a remote resource. The wait time 
(TIME =60) can also be changed. 


See mount(1M) for a description of the options. 
FILES 
/etc/mnttab mount table 


SEE ALSO | 
fumount(1M), fuser(1M), mount(1M), rfstart(1M), rfuadmin(1M), 
setmnt(1M) 
mnttab(4) in the Programmer’s Reference Manual 
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NAME 
™ rmountall, rumountall - mount, unmount Remote File Sharing resources 


SYNOPSIS 
/etc/rmountall [-] " file-systemn-table " [...] 
/etc/rumountall [ -k ] 


DESCRIPTION 
The command rmountall is a Remote File Sharing command used to mount 
remote resources according to a file-system-table. (/etc/fstab is the recommended 
file-systern-table.) The special file name "-" reads from the standard input. 


rumountall causes all mounted remote resources to be unmounted. The -k option 
sends a SIGKILL signal, using fuser(1M), to processes that have files open. 


These commands may be executed only by the superuser. 


The file-system-table format is as follows: 


column 1 block special file name of file system 
column 2 mount-point directory 
column 3 -r if to be mounted read-only; -d if remote 
resource 


column 4 file system type (not used with Remote File 
Sharing) 


column 5+ ignored 


White-space separates columns. Lines beginning with "#" are comments. Empty 
lines are ignored. 


SEE ALSO 


fuser(1M), mount(1M), rfstart(1M) 
signal(2) in the Programmer’s Reference Manual 


DIAGNOSTICS 
No messages are printed if the remote resources are mounted successfully. 


Cc 


Error and warning messages come from mount(1M). 
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NAME 
le runacct - run daily accounting 


SYNOPSIS 
/usr/lib/acct/runacct [mmdd [state]] 


DESCRIPTION 
The procedure 7unacct is the main daily accounting shell procedure. It is 
normally initiated using cron(1M). munacct processes connect, fee, disk, and 
process accounting files. It also prepares summary files for prdaily or billing 
purposes. runacct is distributed only to source code licensees. 


runacct takes care not to damage active accounting files or summary files in the 

event of errors. It records its progress by writing descriptive diagnostic messages 

into active. When an error is detected, a message is written to /dev/console, mail 

[see mail(1)] is sent to root and adm, and runacct terminates. munacct uses a 

series of lock files to protect against re-invocation. The files Jock and lock1 are 

used to prevent simultaneous invocation, and Jastdate is used to prevent more 
TaN than one invocation per day. 


runacct breaks its processing into separate, restartable states using statefile to 
remember the last state completed. It accomplishes this by writing the state 
name into statefile. runacct then looks in statefile to see what it has done and to 
determine what to process next. states are executed in the following order: 


SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wimp file, correcting date changes if 
necessary. 

CONNECT1 Produce connect session records in c#np.h format. 

CONNECT2 Convert c#np.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct.h format. 

MERGE Merge the connect and process accounting records. 

FEES Convert output of chargefee into tacct.h format and 


merge with connect and process accounting records. 


DISK | Merge disk accounting records with connect, process, 
and fee accounting records. 


MERGETACCT Merge the daily total accounting records in daytacct with 
the summary total accounting records in 
/usr/adm/acct/sum/tacct. 
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CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting programs can be 
included here. 

CLEANUP Cleanup temporary files and exit. 


To restart runacct after a failure, first check the active file for diagnostics, then fix 
up any corrupted data files such as pacct or wonp. The lock files and Jastdate file 
must be removed before runacct can be restarted. The argument mmdd is 
necessary if runacct is being restarted, and specifies the month and day for which 
runacct reruns the accounting. Entry point for processing is based on the 
contents of statefile; to override this, include the desired state on the command 
line to designate where processing should begin. 


EXAMPLES 
To start vunacct. 
nohup runacct 2> /usr/adm/acct/nite/fd2log & 


To restart runacct. 
nohup runacct 0601 2> > /usr/adm/acct/nite/fd2log & 


To restart runacct at a specific state. 
nohup runacct 0601 MERGE 2> > /usr/adm/acct/nite/fd2log & 


FILES 
/etc/wtmp 
/usr/adm/pacct* 
/usr/src/cmd/acct/tacct.h 
/usr/src/cmd/acct/ctmp.h 
/usr/adm/acct/nite/active 
/usr/adm/acct/nite/daytacct 
/usr/adm/acct/nite/lock 
/usr/adm/acct/nite/lock1 
/usr/adm/acct/nite/lastdate 
/usr/adm/acct/nite/statefile 
/usr/adm/acct/nite/ptacct* mmdd 


SEE ALSO 
acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), 
cron(1M), fwtmp(1M) 
acctcom(1), mail(1) in the User’s Reference Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 
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BUGS 
f Normally it is not a good idea to restart nunacct in the SETUP state. Run 
SETUP manually and restart using: 


runacct mmdd WIMPFIX 


If runacct failed in the PROCESS state, remove the last ptacct file because it is 
not be complete. 


roan 
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NAME 
sadp - disk access profiler 


SYNOPSIS 
sadp [ -th ] [ -d device[-drive] ] s [ n ] 


DESCRIPTION 
The command sadp reports disk access location and seek distance in tabular or 
histogram form. Cylinder usage and disk distance are recorded in units of eight 
cylinders. 


OPTIONS 
-t The -t option causes the data to be reported in tabular form. 


-h The -h option produces a histogram on the printer of the data. Default is 
-f. 

-d device [-drive | 
The -d option specifies the device. The valid value of device is disk. drive 
specifies the disk drives and it may be a drive number in the range 
supported by device, two numbers separated by a minus (indicating an 
inclusive range), or a list of drive numbers separated by commas. Up to 
eight disk drives may be reported. The -d option may be omitted if only 
one device is present. 


S sadp samples disk activity once every second during an interval of s 
seconds. 


n The sampling is repeated n times. 


EXAMPLE 
The command: 


sadp -d h501-0 900 4 


generates four tabular reports, each describing cylinder usage and seek distance 
of h501 disk drive 0 during a 15-minute interval. 


FILES 
/dev/kmem 
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ma NAME 7 
| | sar: sal, sa2, sadc - system activity report package 


SYNOPSIS 
/usr/lib/sa/sade [t n] [ ofile] 


/usr/lib/sa/sal [t n] 
/usr/lib/sa/sa2 [-ubdycwaqvmprSDA] [-s time] [-e time] [-i sec] 


DESCRIPTION 
System activity data can be accessed at the special request of a user [see sar(1)] 
and automatically on a routine basis as described here. The operating system 
contains a number of counters that are incremented as various system actions 
occur. These include counters for CPU utilization, buffer usage, disk and tape 
I/O activity, TTY device activity, switching and system-call activity, file-access, 
queue activity, inter-process communications, paging and Remote File Sharing. 


sadc and shell procedures, sal and sa2, are used to sample, save, and process 


o™ this data. 


sadc, the data collector, samples system data n times every t seconds and writes 
in binary format to ofile or to standard output. If t and are omitted, a special 
record is written. This facility is used at system boot time, when booting to a 

| multiuser state, to mark the time at which the counters restart from zero. For 

| example, the /etc/init.d/perf file writes the restart mark to the daily data by the 
command entry: 


su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sa ‘ date + %d *" 


The shell script sal, a variant of sadc, is used to collect and store data in binary 
file /usr/adm/sa/sadd where dd is the current day. The arguments ¢ and n cause 
records to be written n times at an interval of t seconds, or once if omitted. The 
entries in /usr/spool/cron/crontabs/sys [see cron (1M)]: 


0 * * * 0-6 /usr/lib/sa/sa1 
i 20,40 8-17 * * 1-5 /usr/lib/sa/sa1 
produce records every 20 minutes during working hours and hourly otherwise. 


The shell script sa2, a variant of sar(1), writes a daily report in file 
/usr/adm/sa/sardd. The options are explained in sar(1). The 
/usr/spool/cron/crontabs/sys entry: 
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5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A 
reports important activities hourly during the working day. YK J 
The structure of the binary daily data file is: 


struct sa { 
struct sysinfo si; /* see /usr/include/sys/sysinfo.h */ 
struct minfo mi; /* defined in sys/sysinfo.h */ 
struck dinfo di; /* RFS info defined in sys/sysinfo.h */ 


int minserve, maxserve; /* RFS server low and high 
? water marks */ 
int szinode; /* current size of inode table */ 
int szfile; /* current size of file table */ 
int szproc; /* current size of proc table */ 
int szickf,; /* current size of file record header 
table */ 
int szickr; /* current size of file record lock 
table */ 
int mszinode; /* size of inode table */ ' 
int mszfile; /* size of file table */ TH 
int mszproc; /* size of proc table */ 
int mszlckf; /* maximum size of file record header 
table */ 
int mszlckr; /* maximum size of file record lock 
table */ 
long inodeovf; /* cumulative overflows of inode 
table */ 
long fileovf; /* cumulative overflows of file table */ 
long procovf; /* cumulative overflows of proc 
table */ 
time t ts; /* time stamp, seconds */ 


long devio[NDEVS][4]; /* device unit information */ 
#define IO OPS 0 /* cumulative I/O requests */ 
#define IO_BCNT 1 /* cumulative blocks transferred */ 
#define IO_ACT 2 /* cumulative drive busy time in 
ticks */ 
#define IO_RESP 3 /* cumulative I/O resp time in ticks */ Ww 
}; 
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FILES 
‘™ fusr/adm/sa/sadd daily data file 
/usr/adm/sa/sardd daily report file 
/tmp/sa.adrfl address file 
SEE ALSO 
cron(1M) 


sag(1G), sar(1), timex(1) in the User’s Reference Manual 
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NAME 
setmnt - establish mount table 


SYNOPSIS 
/etc/setmnt 


DESCRIPTION 
The command setmnt creates the /etc/mnttab table which is needed for both the 
mount(1M) and umount commands. setmnt reads standard input and creates a 
mnttab entry for each line. Input lines have the format: 


filesys node 


where filesys is the name of the file system’s special file (e.g., /dev/dsk/c?d?s? ) 
and node is the root name of that file system. Thus filesys and node become the 
first two strings in the mount table entry. 


FILES 
/etc/mnttab 


SEE ALSO 
mount(1M) 


BUGS 
Problems may occur if filesys or node are longer than 32 characters. 
setmnt silently enforces an upper limit on the maximum number of mnttab 
entries. 
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NAME 
setuname - update utsname structure on disk or in memory 


SYNOPSIS 
/usr/lib/uucp/setuname [ [ -k | -K ] [ -u filename] [ -n nodename] [ -s 
sysname] [ -r release] [ -v version] [ -m machine] | 


DESCRIPTION 
The command setuname displays and changes the utsname structure in a disk 
resident kernel as well as updating the structures in memory. It is especially 
handy for setting the nodename used by uucp and mail. 


When setuname is performed without any options, it reads /unix and /dev/kmem 
and displays the utsname structure found at the address in the /unix symbol table. 
Updating of memory does not take place if the utsname from memory does not 
agree with uname(). Note that only the superuser can change the utsname 
structure. All other users, including uucp, can only display the ustname structure 
by invoking setuname without any options. 


If the nodename entry in utsname of the disk resident version of the kernel 

( /unix ) is changed, the file /ete/ NODENAME is changed to contain the new 
nodename. This file is used by the system administrator when making new 
kernels. When the system administrator remakes the kernel, it changes the 
nodename entry in utsname in the kernel to the name currently in 
/etc/NODENAME . 


OPTIONS 
The options are: 
-k write the new utsname structure into memory and /unix 
-K same as the -k option but do not write onto disk resident copy of 
kernel 


-u filename use filename, otherwise /unix is changed 
-n nodename set new nodename to nodename 

-S sysname set new sysname {to sysname 

-r release set new release to release 

-v version set new version to version 


-m machine set new machine to machine 


UP-14805 Page 1 


SETUNAME (1M) 


If setuname is called without specifying either the -k or the -K option but with the 
-nsyrm options, then only /unix is changed. | 


FILES 
/unix kernel file 
/dev/kmem memory 
/etc-NODENAME 
default nodename used by system administrator to make a kernel 


SEE ALSO 
uname(1) in the User’s Reference Manual 
uname(2) in the Programmer’s Reference Manual 


RESTRICTIONS 
There is no way to specify an alternate filename for memory. 
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NAME 
show - display current hardware configuration 


SYNOPSIS 
show [ -I | -list ] [ -h | -help ] [ pathname | 


DESCRIPTION 
The show command is used to display the current hardware configuration. 
Invoking the show command without any options produces a report that displays 
the current hardware configuration. 


Because the show command uses the UNIX environment, the appropriate device 
driver(s) must be configured in the kernel so that all hardware components can 
be retrieved. 


OPTIONS 
-I | -list 
The -/ option lists the hardware configuration in a data format that can be 
used from a shellscript. Optionally, -ist can be entered. 


-h | -help 
The -h option displays HELP information. The help information includes a 
description of all multibus boards, their corresponding abbreviations, and 
their physical addresses (hexadecimal). Optionally, -help can be entered. 


In addition, the -h option lists all disk device names (block and special/raw) 
and their corresponding major and minor numbers which is helpful if a 
device node must be created using the mknod command. 


pathname 
The pathname option indicates the "full" pathname of the operating system 
(kernel); the default pathname is /unix . 


EXAMPLES 
show 
show -h 
show -l 
show -! /unix.orig 
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NOTES 
If communication drivers are installed and configured in your system, additional / 
information about the MPCC can be obtained by performing mpstat(1M), 
mprset(1M), and mpfw(1M). These commands are available on your system only 
if a communication driver has been installed [see mpstat(1M)]. 


SEE ALSO 
mknod(1M), mpstat(1M) 


RESTRICTIONS 
show should be performed only when there is not any disk, tape, or tty activity on 
the system. 
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NAME 
i | shutdown - shut down system, change system state 


SYNOPSIS 
/etc/shutdown [ -y | [ -ggrace_period [ -iinit_state | 


DESCRIPTION 
This command is executed by the superuser to change the state of the machine. 
By default, it brings the system to a state where only the console has access to the 
UNIX system. This state is traditionally called single-user. 


The command sends a warning message and a final message before it starts 
actual shutdown activities. By default, the command asks for confirmation before 
it starts shutting down daemons and killing processes. The options are used as 
follows: 


-y  pre-answers the confirmation question so the command can be run without 
user intervention. A default of 60 seconds is allowed between the warning 
message and the final message. Another 60 seconds is allowed between the 

c™ final message and the confirmation. 


-gerace_penod 
allows the superuser to change the number of seconds from the 60-second 
default. 


-iinit_state 
specifies the state that init(1M) is to be put in following the warnings, if 
any. By default, system state s is used (the same as states 0 and S). 
Other recommended system state definitions are: 


state 0 
Shut the machine down so it is safe to remove the power. Have the 
machine remove power if it can. The /etc/rc0 procedure is called to do this 


work. 
state 0,s, 8 
Bring the machine to the state traditionally called single-user. The /ete/rc0 
“™ procedure is called to do this work. (Though s and 0 are both used to go 


to single-user state, s only kills processes spawned by init and does not 
unmount file systems. State 0 unmounts everything except root and kills all 
user processes, except those that relate to the console.) 
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state 6 
Stop the UNIX system and reboot to the state defined by the initdefault | 
entry in /etc/inittab. WwW 


SEE ALSO 
init(1M), rc0(1M), rc2(1M) 
inittab(4) in the Programmer’s Reference Manual 
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NAME 
vr single - go from multi-user to single-user mode 


SYNOPSIS 
/etc/single 


DESCRIPTION 
The script single is a shell script program which may be invoked by the superuser 
from any login device to quickly return the system from multi-user mode to 
single-user mode. 


After it is invoked, single displays the message 


Going single-user. Wait for login prompt to appear on the system 
console. 


and sends the TERM signal to the init(1M) process. init responds by returning 
the system to single-user mode. 


| SEE ALSO 


init(1M), shutdown(1M) 
signal(2) in the Programmer’s Reference Manual 
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NAME 
“ spcgetty - set terminal type, modes, speed, and begin application. 


SYNOPSIS 
/etc/spegetty line [ speed [ type ]] loginname 


DESCRIPTION 
The command spcgetty is invoked by init(1M). spcgetty permits an application to 
begin execution on the specified line without user intervention. 
Line Initialization 
spcgetty begins by using the required string argument Jine as the name of a file in 
the /dev directory to open for reading and writing. | 


Default Settings 
If no specific arguments for terminal type or line discipline are given, spcgetty 
does the following: 


Uses raw mode (awakens every character) 

™ Suppresses echo 

| 7 Permits either parity 
Converts newline characters to carriage return and line feed sequences 
Expands tabs on the standard output 


Login Processing 
After line initialization spcgetty passes loginname to login. Loginname may be 
followed by options which are also passed to Jogin. Login places these options in 
the environment [see /ogin (1)]. 


OPTIONAL ARGUMENTS 
speed 
Use speed as a label to a speed and tty definition in the file /ete/gettydefs to 
determine the initial run speed, the initial tty settings, and the next speed to 
try if the speed is inappropriate. 


type Denotes the character string type as the type of terminal connected to /ine. 
rN A few examples of what type may be are: 


none any terminal unknown to the system; default 
vt61 DEC VT61 
vt100 DEC VT100 
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hp45 Hewlett-Packard HP45 
c100 Concept 100 


For a terminal type to be meaningful, the virtual terminal handlers must be 
compiled into the operating system. They are available, but not compiled in 
the default condition. 


loginname 
Identifies the login name in the /etc/passwd file to determine the particular 
application shell to be used. 


FILES 
/etc/gettydefs 


SEE ALSO 
init(1M), tty(7) 
login(1) in the User’s Reference Manual 
ioctl(2), gettydefs(4), inittab(4) in the Programmer’s Reference Manual 


RESTRICTIONS 
Although spcgetty understands simple character quoting conventions, it is not 
possible to quote the special control characters that spcgetty uses to determine 
when the end of line is reached, which protocol is being used, and what is the 
erase character. Therefore, it is recommended that the following characters not 
be used in Joginname: #, @, /, backspace, ~U, ~D, or &. These characters are 
always interpreted as having special meaning. 
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NAME 


c™ strace - print STREAMS trace messages 


SYNOPSIS 
strace [ mid sid level ] ... 


DESCRIPTION 
The command strace without arguments writes all STREAMS event trace 
messages from all drivers and modules to its standard output. These messages 
are obtained from the STREAMS log driver [/og(7)]. If arguments are provided 
they must be in triplets of the form mid, sid, level, where mid is a STREAMS 
module ID number, sid is a sub-ID number, and /evel is a tracing priority level. 
Each triplet indicates that tracing messages are to be received from the given 
module/driver, sub-ID (usually indicating minor device), and priority level equal 
to or less than the given level. The token all may be used for any member to 
indicate no restriction for that attribute. 


The format of each trace message output is: 


™ <seq> <time> <ticks> <level> <flags> <mid> <sid> <text> 


<seq> trace sequence number 

<time> time of message in hh:mm:ss 

<ticks> time of message in machine ticks since boot 
<level> tracing priority level 


<flags> E: message is also in the error log 
F : indicates a fatal error 
N : mail was sent to the system administrator 


<mid> module ID number of source 
<sid> sub-ID number of source 
<text> formatted text of the trace message 


Once initiated, strace continues to execute until terminated by the user. 


( \ EXAMPLES 
Output all trace messages from the module or driver whose module ID is 41: 


strace 41 all all 
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Output those trace messages from driver/module ID 41 with sub-IDs 0, 1, 
Or 2: 


Strace 4101 4111 4120 Oo 


Messages from sub-IDs 0 and 1 must have a tracing level less than or equal to 1. 
Those from sub-ID 2 must have a tracing level of 0. 


CAVEATS 
Due to performance considerations, only one strace process is permitted to open 
the STREAMS log driver at a time. The log driver has a list of the triplets 
specified in the command invocation, and compares each potential trace message 
against this list to decide if it should be formatted and sent up to the strace 
process. Hence, long lists of triplets have a greater impact on overall STREAMS 
performance. Running strace has the most impact on the timing of the modules 
and drivers generating the trace messages that are sent to the strace process. If 
trace messages are generated faster than the strace process can handle them, then 
some of the messages are lost. This last case can be determined by examining 
the sequence numbers on the trace messages output. 


SEE ALSO TA 


log(7) 
STREAMS Programmer’s Guide 
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NAME 
 strclean - STREAMS error logger cleanup program 


SYNOPSIS 
strclean [ -d logdir ] [-a age ] 


DESCRIPTION 
The command strclean is used to clean up the STREAMS error logger directory 
on a regular basis [for example, by using cron(1M)]. By default, all files with 
names matching error.* in /usr/adm/streams that have not been modified in the 
last 3 days are removed. A directory other than /usr/adm/streams can be 
specified using the -d option. The maximum age in days for a log file can be 
changed using the -a option. 


EXAMPLES 
strclean -d /usr/adm/streams -a 3 


has the same result as running strclean with no arguments. 


NOTES 
strclean is typically run from cron(1M) on a daily or weekly basis. 


FILES 
/usr/adm/streams/error.* 


SEE ALSO 
cron(1M), strerr(1M) 
STREAMS Programmer’s Guide 
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NAME 
strerr - STREAMS error logger daemon 


SYNOPSIS 
strerr 


DESCRIPTION 
The command strerr receives error log messages from the STREAMS log driver 
(/og(7)| and appends them to a log file. The error log files produced reside in 
the directory /usr/adm/streams, and are named errorsnm-dd, where mm is the 
month and dd is the day of the messages contained in each log file. 


The format of an error log message 1s: 
<seq> <time> <ticks> <flags> <mid> <sid> <text> 
<seq> error sequence number 
<time> time of message in hh:mm:ss 
<ticks> time of message in machine ticks since boot priority level 


<flags> TT: the message was also sent to a tracing process 
F : indicates a fatal error 
N : send mail to the system administrator 


<mid> module ID number of source 
<sid> sub-ID number of source 
<text> formatted text of the error message 


Messages that appear in the error log are intended to report exceptional 
conditions that require the attention of the system administrator. Those messages 
which indicate the total failure of a STREAMS driver or module should have the 
F flag set. Those messages requiring the immediate attention of the 
administrator have the N flag set, which causes the error logger to send the 
message to the system administrator through mail(1). The priority level usually 
has no meaning in the error log but does have meaning if the message is also sent 
to a tracer process. Once initiated, strerr continues to execute until terminated by 
the user. Commonly, strerr would be executed asynchronously. 


CAVEATS 
Only one strerr process at a time is permitted to open the STREAMS log driver. 


If a module or driver is generating a large number of error messages, running the 
error logger causes a degradation in STREAMS performance. If a large burst of 
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messages is generated in a short time, the log driver may not be able to deliver 
some of the messages. This situation is indicated by gaps in the sequence 


numbering of the messages in the log files. 


FILES 
/usr/adm/streams/error s1m-dd 


SEE ALSO 


log(7) 
STREAMS Programmer’s Guide 
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NAME 
f~, sublock - display contents of superblock from hard disks and floppy disks. 


SYNOPSIS 
sublock <device pathname > 


DESCRIPTION 
The command sublock reads the superblock from the specified disk device and 
produces a formatted report to standard output. 


The device pathname used as a parameter must be a character special device 
partition, for example /dev/rdsk/0s1, /dev/rdsk/2s1, or /dev/rfdsk/0s0. 


If sublock is invoked with no parameter, sublock issues an invocation syntax help 
line. 
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NAME 
- swap - swap administrative interface 


SYNOPSIS 
/etc/swap -a swapdev swaplow swaplen 
/etc/swap -d swapdev swaplow 
/etc/swap -l 


DESCRIPTION 
The command swap provides a method of adding, deleting, and monitoring the 
system swap areas used by the memory manager. 


OPTIONS 
-a___ Add the specified swap area. swapdev is the name of block special 
partition (e.g., /dev/dsk/c0d0sf ). swaplow is the offset in 512-byte blocks 
relative to the start of the partition where the swap area should begin. 
swaplen is the length of the swap area in 512-byte blocks. This option can 
only be used by the superuser. Swap areas are normally added by the 
system start-up routine /etc/rcl when going into multi-user mode. 


-d Delete the specified swap area. swapdev is the name of block specal 
partition, (e.g., /dev/dsk/c0d0sf ). swaplow is the offset in 512-byte blocks 
into the partition where the swap area started. Using this option marks the 
swap area as “being deleted." The system does not allocate any new blocks 
from the area, and tries to free swap blocks from it. The area remains in 
use until all blocks from it are freed. This option can only be used by the 
superuser. . 


-| _—_ List the status of all the swap areas. The output has five columns: 


PATH 
The swapdev special file for the swap area if one can be found in the 
/dev/dsk or /dev directories. 


DEV Major/minor device number in decimal for location of path 
directories. 


SWAPLO 
The swaplow value for the area in 512-byte physical blocks. 


BLOCKS 
The swaplen value for the area in 512-byte blocks. 
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FREE 
The number of free 512-byte blocks in the area. If the swap area is | 
being deleted, this column is marked (indel). a 
EXAMPLES 


Add 10,000 blocks beginning at an offset of 10 blocks from the start of partition: 
15 to the swap area: 


swap -a /dev/dsk/cOd0sf 10 10000 


WARNINGS 
No check is done to see if a swap area being added overlaps with an existing 
swap area or file system. 


RESTRICTIONS 
The swap area should only be deleted while in single-user mode. If the swap 
area is deleted in multi-user mode while there is moderate to high system usage, 
unpredictable results could occur. 
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fn NAME 


swapadd - add swap area 


| SYNOPSIS 
| /etc/swapadd [ - ] [ swap table ] 


DESCRIPTION 
The command swapadd changes the size of the swap area according to 
swap _table. If swap_table is not specified, the system swap table /etc/swapnodes 
is used. The special file name "-" reads from the standard input. 


swapadd makes sure that the file system to be added is not mounted and that it is 
not in use. | 


This command can be performed only by the superuser. 


TABLE FORMAT 
White space separates the entries in the swap_table. Lines beginning with "#" 
| are comments. Empty lines are ignored. The format of the swap_table is: 


column 1_ block special file name of file system 
column 2 initial swap block in file system 
column 3 size of swap area in file system 
Example: 


/dev/dsk/c0d0s1 0 1000 
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NAME 
sysdef - output system definition 


SYNOPSIS 
/etc/sysdef [ -hdostA ] [ system_namelist ] 


DESCRIPTION 
The command sysdef outputs the current system definition in tabular form. It 
lists different types or information depending upon the option specified. It 
generates the output by analyzing the named operating system file 
(system_namelist) and extracting the configuration information from the name list 
itself and from the Start-Up Subsystem Interface Area. 


OPTIONS 
-h prints helpful information about the sysdef(1M) command. 


-d__ lists all hardware devices. Device nodes are displayed if the device has been 
configured, as well as the drive identifier of formatted disk devices. 


-0 lists optional hardware information such as the amount of system memory, 
whether or not a hardware floating point coprocessor is installed, etc. 


-s __ lists all system devices, such as rootdev and swapdev. 
-t lists the values of all kernel tunable parameters, such as maxumem, nprocs. 


-A___ displays all system information. 


FILES 
/unix default operating system file (where the system namelist is) 


SEE ALSO 
nlist(3C) in the Programmer’s Reference Manual 


DIAGNOSTICS 
internal name list overflow 
If the master table contains more than an internally specified number of 
entries for use by niist(3C). 
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NAME 
throttle - DMA burst selection for 8 inch Winchester disks 


SYNOPSIS 
/etc/throttle -d /dev/rdsk/[{2-5]sO -n [0-5] [-v] 


DESCRIPTION 
The command throttle permits the selection of the DMA burst length value on a 
per-drive basis for the 8 inch disk controller used with the older two-board SMD 
controller board set. By changing the DMA burst length value, the DMA data 
rate may be increased sufficiently during certain activities, such as operation with 
streaming tape during backup, restore, and installation, and then restored to its 
original setting upon completion of the operation. 


The throttle command is invoked before an operation, in which a higher 
throughput rate is necessary, in order to increase the DMA throttle, and is then 
invoked again after the operation in order to lower the throttle to its original 
value. 


OPTIONS 
-d The -d option is used to specify the raw device name of the device for 
which the higher data transfer rate is to be used. The devices which support 
this presently are the 8 inch Winchester devices; however, no error is 
generated if other valid devices are selected (in this case, no action is 
performed by the command). 


-n The -n option specifies the throttle number selected. The valid values are 
0-5, and are indicative of the number of DMA words which are transferred 
per DMA burst. The values are defined as follows. 


0 = 4 words per DMA burst (driver default value) 
1 = 4 words per DMA burst 

2 = 8 words per DMA burst 

3 = 16 words per DMA burst 

4 = 32 words per DMA burst 

5 = 64 words per DMA burst 


-v The -v option displays status messages. 


FILES 
/dev/rdsk/{2-5]s[0-f] 
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SEE ALSO 
format(1M), xl(7) 


RESTRICTIONS 
throttle only operates on 8 inch disks connected to the older two-board SMD disk 
controller. The throttle command is not permanent, as it only changes the value 
used in memory. The default value, which is kept in the bootblock for each 8 inch 
device, is set at power-up and after formatting. 


throttle must not be used in multi-user mode, or in single-user mode when there 
is a lot of bus activity, as the effects of acquiring more bus bandwidth by the 
SMD controller have a negative impact on other bus masters. 


throttle must be used in a pair-wise fashion. That is, if the throttle is increased for 
certain operations, it must be subsequently lowered. 
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NAME 


TIC(1M) 


tic - terminfo compiler 


SYNOPSIS 


tic [-v[n]] [-c] file 


DESCRIPTION 
The command fic translates a terminfo(4) file from the source format into the 
compiled format. The results are placed in the directory /usr/lib/terminfo. The 
compiled format is necessary for use with the library routines described in 
curses(3X). 


-vn 


file 


(verbose) output to standard error trace information showing fic’s 
progress. The optional integer n is a number from 1 to 10, inclusive, 
indicating the desired level of detail of information. If n is omitted, the 
default level is 1. If is specified and greater than 1, the level of detail 
is increased. 


only check file for errors. Errors in use= links are not detected. 


contains one or more terminfo(4) terminal descriptions in source format 
[see terminfo(4)]. Each description in the file describes the capabilities 
of a particular terminal. When a use=entry-name field is discovered in 
a terminal entry currently being compiled, fic reads in the binary from 
/usr/lib/terminfo to complete the entry. (Entries created from file are 
used first. If the environment variable TERMINFO is set, that directory 
is searched instead of /usr/lib/terminfo.) tic duplicates the capabilities 
in entry-name for the current entry, with the exception of those 
capabilities that explicitly are defined in the current entry. 


If the environment variable TERMINFO is set, the compiled results are placed 
there instead of /usr/lib/terminfo. 


FILES 


/usr/lib/terminfo/?/* compiled terminal description data base 


SEE ALSO 


curses(3X), term(4), terminfo(4) in the Programmer’s Reference Manual 
Chapter 10 in the Programmer’s Guide 


WARNINGS 


Total compiled entries cannot exceed 4096 bytes. The name field cannot exceed 
128 bytes. 
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Terminal names exceeding 14 characters are truncated to 14 characters and a 
warning message is printed. 


When the -c option is used, duplicate terminal names are not diagnosed. 
However, if -c is not used, duplicate names are diagnosed. 


BUGS 
To allow existing executables from the previous release of the UNIX System to 
continue to run with the compiled terminfo entries created by the new terminfo 
compiler, cancelled capabilities are not marked as cancelled within the terminfo 
binary unless the entry name has a "+" within it. (Such terminal names are only 
used for inclusion within other entries by means of a use= entry. Such names 
would not be used for real terminal names.) 


For example: 
4415 + nl, kf1@, kf2@, .... 


4415 + base, kf1=\EOc, kf2=\EOd, .... 


4415-nl| 4415 terminal without keys, 
use = 4415 + nl, use = 4415 + base, 


The above example works as expected; the definitions for the keys do not show 
up in the 4415-nl entry. However, if the entry 4415+n/ did not have a plus sign 
within its name, the cancellations would not be marked within the compiled file 
and the definitions for the function keys would not be cancelled within 4415-n/. 


DIAGNOSTICS 
Most diagnostic messages produced by fic during the compilation of the source 
file are preceded with the approximate line number and the name of the terminal 
currently being worked on. 


mkdir ... returned bad status 
The named directory could not be created. 


File does not start with terminal names in column one 
The first thing seen in the file, after comments, must be the list of 
terminal names. 


Token after a seek(2) not NAMES 
Somehow the file being compiled changed during the compilation. 


Not enough memory for use_list element 
or 
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Out of memory 
Not enough free memory was available (malloc (3) failed). 


Can’t open ... 
The named file could not be created. 


Error in writing ... 
The named file could not be written to. 


Can’t link ... to ... 
A link failed. 


Error in re-reading compiled file ... 
The compiled file could not be read back in. 


Premature EOF 
The current entry ended prematurely. 


Backspaced off beginning of line 
This error indicates something wrong happened within fic. 


Unknown Capability - "..." 
The named invalid capability was found within the file. 


Wrong type used for capability "..." 
For example, a string capability was given a numeric value. 


Unknown token type 
Tokens must be followed by "@" to cancel, "," for booleans, "#" for 
numbers, or "=" for strings. 


"...": bad term name 
or 
Line ...: Hlegal terminal name - 
Terminal names must start with a letter or digit 
The given name was invalid. Names must not contain white space or 
slashes, and must begin with a letter or digit. 


" Off 


FW S 
ese e@ 


terminal name too long. 
An extremely long terminal name was found. 


n on, 


terminal name too short. 
A one-letter name was found. 


"..." filename too long, truncating to ".. 
The given name was truncated to 14 characters due to UNIX file name 
length limitations. 


" 
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." defined in more than one entry. Entry being used is "...". 


An entry was found more than once. 


Terminal name "..." synonym for itself 


A name was listed twice in the list of synonyms. 


At least one synonym should begin with a letter. 


Illegal character - 


At least one of the names of the terminal should begin with a letter. 


"oO 
eee 


The given invalid character was found in the input file. 


Newline in middle of terminal name 


The trailing comma was probably left off of the list of names. 


Missing comma 


A comma was missing. 


Missing numeric value 


The number was missing after a numeric capability. 


NULL string value 


The proper way to say that a string capability does not exist is to cancel 
it. 


Very long string found. Missing comma? 


self-explanatory 


Unknown option. Usage is: 


An invalid option was entered. 


Too many file names. Usage is: 
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... non-existent or permission denied 


The given directory could not be written into. 


... 1s not a directory 


self-explanatory 


...': Permission denied 


access denied. 


....: Not a directory 


tic wanted to use the given name as a directory, but it already exists as a 
file 
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SYSTEM ERROR!! Fork failed!!! 
A fork(2) failed. 


Error in following up use-links. Either there is a loop in the links or they 

reference non-existent terminals. The following is a list of the entries involved: 
A terminfo(4) entry with a use=name capability either referenced a non- 
existent terminal called name or name somehow referred back to the given 
entry. 
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NAME 
“™ tpaccess - update GPTF access rights 


SYNOPSIS 
tpaccess [ -d ] -u (userid)! -u (username); -g (groupid) | -g (groupname) 
-f (prilim) {| -p (prilim); -t 


DESCRIPTION 
Only superusers can use tpaccess. tpaccess defines the highest level of priority 
that users and user groups can assign to shell commands through the tpset 
command. When a superuser uses tpaccess to establish or update access rights to 
tpset, the entries are put into the control file /etc/gptfctrl. If /etc/gptfctri does not 
exist, only a superuser can use the spset command to set priority on process IDs 
and commands. 


tpaccess returns a zero (0) if successful, -1 if it detects an error. 
OPTIONS 


-d Specifies that you are performing a delete operation. If you do not use this 
i option, tpaccess assumes you are performing an insert/update operation. 


-u(userid) |-u(username) | 

-2(groupid) |-g(groupname) 
The -u option specifies user ( -w) or group ( -g) to which you are assigning 
access rights. The user (or group) can be specified as either an ID 
(positive integer) or a name. 

-f(prili) | -p(prilim) | -t 
Access right must be one of the following: 


-{(prilim) fixed priority 
-p(prilim) _ real-time priority 
-t transaction capability 


Specifying the -f option enables the user or user group to set only fixed 
priority up to the highest priority supplied in (prilim). 


Specifying the -p option enables the user or user group to set both fixed 
| ti’ and real-time priority up to the highest real-time priority supplied in 
! (prilim). The highest possible fixed priority, 60, is implied. 


UP-14805 Page 1 


a 


TPACCESS (1M) 


Specifying the -t option enables the user or user group to set process 
residency, fixed priority, and real-time priority, with access to the highest 
priority in both groups. 


Fixed priority is an integer in the range 60 to 127, where 60 is the highest 
(best) priority. Real-time priority is an integer in the range 0 to 19 or 40 to 
59. Integers in the range, 0..19, are mapped to the range, 40..59, and 0 is 
the highest priority. 


EXAMPLES 
The following example gives user U1 transaction capability rights. 
tpaccess -uU1 -t 


The following example gives user U2 the right to use fixed priorities from 60 to 
127 and real-time priorities from 10 to 19. 


tpaccess -uU2 -p10 
The following example deletes the entry for the group GRP. 
tpaccess -d -gGRP 
FILES 
/etc/gptfctrl 


/etc/passwd 
/etc/group 


SEE ALSO 
tpset(1M) 
tps(1) in the User’s Reference Manual 
tpfix(2), tpprio(2), tpset(2) in the Programmer’s Reference Manual 
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NAME 
f™~ tpset - set the GPTF flag on a process 
SYNOPSIS 
tpset [ -t | -r] [ -f [(pri)} -p (pri)] (pid) | (shemd) 
DESCRIPTION 


The command ¢pset enables superusers to assign transaction capability, residency, 
fixed priority, or real-time priority to a command (shcrnd), and fixed or real-time 
priority to a process (pid). Users also use tpset to give shell commands 
transaction capability, residency, fixed priority, or real-time priority, but only 
according to the limits defined for them by the superuser through the tpaccess 


command. 
OPTIONS 
-t Give shcmd transaction capability; you cannot specify pid with this 
option. 
-r Perform shcmd in a resident process with transaction capability; you 
rr cannot specify pid with this option. 


-f(pri) Give either the command, shcmd, or the process, pid, the fixed priority 
in pi. Pri must be an integer in the range 60..127. 


-p(pri) Give either the command, shcmd, or the process, pid, the real-time 
priority in pri. Pri must be an integer in the range 0..19 or 40..59. 
Integers in the range, 0..19, are mapped to the range, 40..59. 


(pid) ID of the process whose priority is altered. 
(shemd) A text string identifying the command being executed with special 


rights. 


When using this command, you must have superuser status to specify a process 
ID (pid). To specify a command (shcmd), you must be either a superuser or 
have access rights through tpaccess. 


EXAMPLES 
Make a shell with transaction capability: 


O tpset -t sh 
Start a program PRG with real-time priority 10: 
tpset -pl0 PRG 
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Give the process with process ID 151 a fixed priority of 60: 


tpset -£60 151 


EXIT CODES 
0 If successful 


>0 If error(s) encountered 


FILES 
/etc/gptfctrl maintained by tpaccess 


/etc/passwd read by tpaccess 
/etc/group read by tpaccess 


SEE ALSO 


tpaccess(1M) 
tps(1) in the User’s Reference Manual 
tpfix(2), tpprio(2), tpset(2) in the Programmer’s Reference Manual 
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NAME 
-tune_sys - an interactive kernel tuning utility 


SYNOPSIS 
/etc/tune_sys 


DESCRIPTION 
The tune_sys utility examines each board in the system, determines the current 
tunable parameter values for the operating system kernel, and suggests values for 
a reasonably well-tuned kernel based on the determined configuration. After you 
invoke the tune_sys command, your screen displays the current and suggested 
kernel parameters and your options as follows: 


4 MB Physical Memory U 5000/30/35/50/55 


Buffers Hashbufs Clists Files Inodes Procs MaxProc Regions 


Current: 256 128 2320 300 300 200 25 
Suggested: 400 912 780 200 200 90 35 
Modified: 256 912 2320 300 300 200 25 


Please pick one of the following options: 

1. Modify a kernel parameter. 

2. Build and load a new kernel with suggested kernel parameters. 
3. Build and load a new kernel with modified kernel parameters. 
4. Exit "tune_sys" making no changes. 


If you modify a kernel parameter (Option 1), accept the suggested kernel values 
(Option 2) or modify individual kernel parameters (Option 3), tune_sys then 
builds a new operating system kernel with the new parameter values, moves the 
new kernel to the appropriate place, backs up the original kernel, unmounts file 
systems, syncs up the system, and prompts for a reboot. If you want to exit 
tune_sys with no changes, choose Option 4. 


The tunable parameters have the following function: 


Buffers Buffers specifies the number of 1-kilobyte disk cache buffers. This 
parameter can drastically impact disk performance. 


Hashbufs Hashbufs specifies the size of a table used in the disk cache system. 
This value is always determined by tune_sys. 


Clists Clists specifies the number of character list buffers (cblocks). 
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files Files specifies the maximum number of open files system wide. 
Inodes Inodes specifies the maximum number of active inodes system wide. | 
Procs Procs specifies the maximum number of concurrent processes system 

wide. 


MaxProc MaxProc specifies the maximum number of processes per user. 


Regions Regions specifies the maximum number of active regions system wide. 
In general each process requires 2 or 3 regions. tune_sys does not 
make recommendations on regions values. 


fune_sys bases suggested kernel parameters on the size of main memory, as 
outlined in the following table: 


Suggested UNIX Kernel Tunable Parameters 
Based on Size of Main Memory 


Memory Buffers Hashbufs Clists Files Inodes Procs Max Proc Regions 


2 MB 256 512 660 eo lf 70 35 140 | 
4 MB 400 512 780 200 200 90 35 146 Ww 
6 MB 600 1024 900 225 225 110 35 152 
8 MB 800 1024 1020 250 250 130 35 158 
10 MB 800 1024 1140 275 275 150 35 164 
12 MB 800 1024 1260 300 300 170 35 170 
14 MB 800 1024 1380 300 300 190 35 176 
16 MB 800 1024 1500 300 300 210 35 182 
FILES 
/etc/icb determines hardware configuration 
/etc/mount mounts and unmounts file systems left mounted 
/etc/crash determines current kernel tunable parameters 


/kernel/unisys/conf/systems/system.admin 
contains data file with kernel tunable parameter 


values ; 
/kernel/unisys/conf/kernels contains built kernel a 
/kernel/Makefile makes file for building a new kernel 
/usr/bin/show determines amount of memory in system 
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RESTRICTIONS 
Because tune_sys bases suggestions on the hardware configuration only, the 
suggested values may not always produce a well-tuned system for a specific 
application environment. 


tune_sys makes kernel tuning suggestions in multiuser mode, but implements 
kernel modifications in single-user mode only. 


tune_sys must be run by a superuser to successfully determine the current 
hardware and kernel parameter configuration. 


tune_sys uses the current configured NODE name for the new kernel. The new 
kernel is named $NODE.$date, where $date is the current date. 
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fn uadmin - administrative control 


SYNOPSIS 


/etc/uadmin cmd fen 


DESCRIPTION 
The command uadmin provides control for basic administrative functions. This 
command is tightly coupled to the system administrative procedures and is not 
intended for general use. It may be invoked only by the superuser. 


COMMANDS 
As specified by cmd, the following commands are available: 


2 
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The system is shut down. All user processes are killed, the buffer cache is 
flushed, and the root file system is unmounted. The action to be taken after 
the system has been shut down is specified by fen. The functions are 
generic; the hardware capabilities vary on specific machines. 


0 Halt the processor and turn off the power. 
1 Reboot the system, using /unix. 


2 Interactive reboot; user is prompted for system name. 


The system stops immediately without any further processing. The action 
to be taken next is specified by fen as above. 


The root file system is mounted again after having been fixed. This should 
be used only during the startup process. 


SEE ALSO 
uadmin(2) in the Programmer’s Reference Manual 
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NAME 
unadv - unadvertise a Remote File Sharing resource 


SYNOPSIS 
unadv resource 


DESCRIPTION 
The command unadv unadvertises a Remote File Sharing resource, which is the 
advertised symbolic name of a local directory, by removing it from the advertised 
information on the domain name server. unadv prevents subsequent remote 
mounts of that resource. It does not affect continued access through existing 
remote or local mounts. 


An administrator at a server can unadvertise only those resources that physically 
reside on the local machine. A domain administrator can unadvertise any 
resource in the domain from the primary name server by specifying resource 
name as domain.resource. (A domain administrator should only unadvertise 
another host’s resources to clean up the domain advertise table when that host 
goes down. Unadvertising another host’s resources changes the domain advertise 
table, but not the host advertise table.) 


This command is restricted to the superuser. 


ERRORS 
If resource is not found in the advertised information, an error message 1s sent to 
standard error. 


SEE ALSO 
adv(1M), fumount(1M), nsquery(1M) 
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NAME 
i | uucheck - check the uucp directories and permissions file 


| SYNOPSIS 
| /usr/lib/uucp/uucheck [ -v ] [ -x debug level ] 


DESCRIPTION 
The command uucheck checks for the presence of the uucp system required files 
and directories. Within the uucp makefile, it is executed before the installation 
takes place. It also checks for some obvious errors in the 
/usr/lib/uucp/Permissions (Permissions) file. When executed with the -v option, 
it gives a detailed explanation of how the uucp programs interpret the 
Permissions file. The -x option is used for debugging. debug-option is a single 
digit in the range 1-9; the higher the value, the greater the detail. 


Note that uucheck can only be used by the superuser or uucp. 


FILES 

TN /usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuscheds 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 


SEE ALSO 
uucico(1M), uusched(1M) 
uucp(1C), uustat(1C), uux(1C) in the User’s Reference Manual 


BUGS 
The program does not check file/directory modes or some errors in the 
Permissions file such as duplicate login or machine name. 
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nS 


} uucico - file transport program for the uucp system 


SYNOPSIS 
/usr/lib/uucp/uucico [ -r role_number ] [ -x debug_level ] 
[ -i interface ] [ -d spool_directory ] -s system_name 


DESCRIPTION 
The program uucico is the file transport program for wucp work file transfers. 
Role numbers for the -r are the digit 1 for master mode or 0 for slave mode 
(default). The -r option should be specified as the digit 1 for master mode when 
uucico is started by a program or cron. uux and uucp both queue jobs that are 
transferred by uucico. It is normally started by the scheduler, uusched , but can 
be started manually; this is done for debugging. For example, the shell uutry 
starts uucico with debugging turned on. A single digit must be used for the -x 
option with higher numbers for more debugging. 


The -i option defines the interface used with uucico. This interface only affects 

c™ slave mode. Known interfaces are UNIX (default), TLI (basic Transport Layer 
Interface), and TLIS (Transport Layer Interface with Streams modules, 
read/write). 


FILES 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Devconfig 
/usr/lib/uucp/Sysfiles 
/usr/lib/uucp/Maxuuxqts 
/usr/lib/uucp/Maxuuscheds 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 


SEE ALSO 


ma cron(1M), uusched(1M), uutry(1M) 
| uucp(1C), uustat(1C), wux(1C) in the User’s Reference Manual 
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NAME 
-uucleanup - uucp spool directory clean-up 


SYNOPSIS 
/usr/lib/uucp/uucleanup [ -Ctime | [ -Dume | [ -Wame | [ -Xtime | 
[ -mstring | [ -otime ] [ -ssystem ] 


DESCRIPTION 
The command uucleanup scans the spool directories for old files and takes 
appropriate action to remove them in a useful way: 


Inform the requestor of send/receive requests for systems that can not be 
reached. 


Return mail, which cannot be delivered, to the sender. 


Delete or execute rnews for rnews type files (depending on where the 
news originated--locally or remotely). 


Remove all other files. 


In addition, there is provision to warn users of requests that have been waiting 
for a given number of days (default 1). Note that uucleanup processes as if all 
option fimes are specified to the default values unless time is specifically set. 


The following options are available. 


-Ctime Any C. files greater or equal to time days old are removed 
with appropriate information to the requestor. (default 7 
days) 

-Dtime Any D. files greater or equal to fime days old are removed. 


An attempt is made to deliver mail messages and execute 
rnews when appropriate. (default 7 days) 


-Wiime Any C. files equal to time days old cause a mail message to 
be sent to the requestor warning about the delay in 
contacting the remote. The message includes the JOBID, 
and in the case of mail, the mail message. The 

f™. administrator may include a message line telling whom to 
call to check the problem (-m option). (default 1 day) 


-Xtime Any X. files greater or equal to time days old are removed. 
The D. files are probably not present (if they were, the X. 
could get executed). But if there are D. files, they are taken 
care of by D. processing. (default 2 days) 
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-mst7ing This line is included in the warning message generated by 
the -W option. 
-otime Other files older than time days are deleted. (default 2 


days) The default line is "See your local administrator to 
locate the problem." 


-ssystem Execute for system spool directory only. 


-xdebug level The -x debug level is a single digit between 0 and 9; higher 
numbers give more detailed debugging information. (If you 
compile uucleanup with -DSMALL, debugging output is not 


available.) 
This program is typically started by the shell uudemon.cleanup, which should be 
started by cron(1M). 
FILES 
/usr/lib/uucp directory with commands used by uucleanup internally 
/usr/spool/uucp spool directory 
SEE ALSO 
cron(1M) 


uucp(1C), uux(1C) in the User’s Reference Manual 
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o™ NAME 
| ) uugetty - set terminal type, modes, speed, and line discipline 


SYNOPSIS 
/usr/lib/uucp/getty [ -h ] [ -t timeout ] [ -r ] line 
[ speed [ type [ linedisc | | ] 
/usr/lib/uucp/getty -c file 


DESCRIPTION 

The command wugetty is identical to getty(1M) but changes have been made to 
support using the line for uucico, cu, and ct; that is, the line can be used in both 
directions. The uugetty allows users to log in, but if the line is free, uucico, cu, or 
ct can use it for dialing out. The implementation depends on the fact that uucico, 
cu, and ct create lock files when devices are used. When the open() returns (or 
the first character is read when -r option is used), the status of the lock file 
indicates whether the line is being used by uucico, cu, ct, or someone trying to log 
in. Note that in the -r case, several <carriage-return> characters may be 

lon required before the login message is output. The human users are able to handle 
this slight inconvenience. uucico trying to log in has to be told by using the 
following login script: 


™ \r\d\r\d\r\d\r in:--in: .. . 
where the . . . is whatever would normally be used for the login sequence. 


An entry for an intelligent modem or direct line that has a uugetty on each end 
must use the -r option. (This causes uugetty to wait to read a character before it 
puts out the login message, thus preventing two uugettys from looping.) If there 
is a uugetty on one end of a direct line, there must be a uugetty on the other end 
as well. Here is an /etc/inittab entry using uugetty on an intelligent modem or 
direct line: 


30:2:respawn:/usr/lib/uucp/uugetty -r -t 60 tty12 1200 
FILES 


/etc/gettydefs 
/etc/issue 


A SEE ALSO 


uucico(1M), getty(1M), init(1M), tty(7) 
ct(1C), cu(1C), login(1) in the User’s Reference Manual 
ioctl(2), gettydefs(4), inittab(4) in the Programmer’s Reference Manual 
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BUGS 


ct does not work when uugetty is used with an intelligent modem such as penril or 
ventel. 
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NAME 
fF uusched - the scheduler for the uucp file transport program 


SYNOPSIS 
/usr/lib/uucp/uusched [ -x debug level ] [ -u debug level | 


DESCRIPTION 
The command uusched is the uucp file transport scheduler. It is usually started 
by the daemon uudemon.hour that is started by cron(1M) from an entry in 
/usr/spool/cron/crontab: 


39 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.hour > /dev/null" 


| The two options are for debugging purposes only; -x debug level outputs 

) debugging messages from uusched and -u debug level is passed as -x debug level 

) to uucico. The debug level is a number between 0 and 9; higher numbers give 
more detailed information. 


FILES 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 


SEE ALSO 
cron(1M), uwucico(1M) 
uucp(1C), uustat(1C), uux(1C) in the User’s Reference Manual 
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NAME 
Uutry, uukick - try to contact remote system with debugging on 


SYNOPSIS 
/usr/lib/uucp/Uutry [ -x debug level ] [ -r ] system_name 
/usr/lib/uucp/uukick system_name 


DESCRIPTION 
The script Uutry is a shell script that is used to invoke uucico to call a remote 
system. Debugging is turned on (default is level 5). 


uukick is a shell script that is used to invoke uucico to call the remote system. 
uukick automatically removes the /usr/spool/uucp/.Status file for the particular 
remote system and starts the uucico in the background without debug output. 


OPTIONS 
-x The -x option for Uutry specifies the debug level and overrides the default 
value. The value for debug level can be 1 pe 9. The higher the number, 
the more information is provided. 


-r The -r option for Uutry overrides the retry time defined in the 
/usr/spool/uucp/.Status file. The -r option is only valid for uucp and 
superuser. 


system_name 
System_name is the name of the remote system. 


For Uutry, the debugging output is put in file /amp/system_name. A tail -f of 
the output is executed. An interrupt gives control back to the terminal while 
the uucico continues to run, putting its output in /fmp/system_name. 


FILES 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuscheds 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 
/tmp/system_name 


UP-14805 Page 1 


UUTRY (1M) 


SEE ALSO 


uucico(1M) a 
uucp(1C), wux(1C) in the User’s Reference Manual 
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NAME 
uuxqt - execute remote command requests 


SYNOPSIS 
/usr/lib/uucp/uuxqt [ -s system ] [ -x debug level ] 


DESCRIPTION 
uuxgt is the program that executes remote job requests from remote systems 
generated by the use of the wux command. (mail uses uux for remote mail 
requests). uuxgt searches the spool directories looking for X. files. For each X. 
file, uuxgt checks to see if all the required data files are available and accessible, 
and file commands are permitted for the requesting system. The Permissions file 
is used to validate file accessibility and command execution permission. 


There are two environment variables that are set before the uuxgt command is 
executed: 


UU_MACHINE is the machine that sent the job (the previous one). 
UU_USER is the user that sent the job. 


These can be used in writing commands that remote systems can execute to 
provide information, auditing, or restrictions. 


The -x debug level is a single digit between 0 and 9. Higher numbers give more 
detailed debugging information. 


FILES 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 


SEE ALSO 


uucico(1M) 
uucp(1C), uustat(1C), uux(1C), mail(1) in the User’s Reference Manual 
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NAME 
c™ verify - turn on/off read after write check for device 


SYNOPSIS 
verify /dev/rdsk/xsy on {| off 


DESCRIPTION 
The command verify turns on or off the Winchester disk read after write verify 
feature. When activated, verify follows all write operations on the specified disk 
with a read of the block and a data verify. verify reports any errors encountered 
by the read or verify back to the application as input/output errors. 


The device name can represent any partition on the disk. Note, however, that 
verify is not selective as to which partition, only to which device. This means that 
verify can be turned off or on for a device only, and not for a partition on that 
device. It must be a character special device name; for example, 
/dev/rdsk/cOd0s1 . 


Invocation with no parameters produces a help line giving the syntax of 


™ invocation. 


The impact on system performance by this feature is obviously great. It 1S 
recommended that the use be limited except as necessary as all write operations 
on the disk are affected. 


DIAGNOSTICS 
A message is printed as the result of an invalid invocation. 


EXIT STATUS 
An exit status of 1 indicates an invalid invocation. An exit status of 0 indicates a 
successful invocation. 


RESTRICTIONS 
The read after write function is not selectable for an individual file or partition. 
The read after write function is only performed for block I/O; it is not performed 
for raw V/O. 


| 
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NAME 
_volcopy, labelit - copy file systems with label checking 


SYNOPSIS 
/etc/volcopy [options] fsname speciall volnamel1 special2 volname2 


/etcfabelit special [ fsname volname [ -n ] | 


DESCRIPTION 
The command volcopy makes a literal copy of the file system using a blocksize 
matched to the device. The program requests length, density, and capacity 
information if it is not given on the command line or is not recorded on an input 
tape label. The density specified with the -bpi option should match the actual 
density of the drive. If the file system is too large to fit on one reel, volcopy 
prompts for additional reels. Labels of all reels are checked. Tapes may be 
mounted alternately on two or more drives. If volcopy is interrupted during the 
actual copy, it asks if the user wants to quit or wants a shell. In the latter case, 
the user can perform other operations (e.g, /abelit) and return to volcopy by 
exiting the new shell. 


labelit can be used to provide initial labels for unmounted disk or tape file 
systems. With the optional arguments omitted, /abelit prints current label values. 
The -n option provides for initial labeling of new tapes only (this destroys 
previous contents). 


ARGUMENTS | 
The fsname argument represents the name (e.g., root, ul, etc.) of the file system 
being copied. | 
The special should be the physical disk section or tape (e.g., /devw/rdsk/c0d0s1, 
/dev/rtp, etc.). 


The volname is the physical volume name (e.g., voll, etc.) and should match the 
external label sticker. Such label names are limited to six or fewer characters. 
volname may be - to use the existing volume name. 


Speciall and volname!] are the device and volume from which the copy of the file 
system is being extracted. Special2 and volname2 are the target device and 
volume. 


Fsname and volname are recorded in the last 12 characters of the superblock 
(char fsname[6], volname[6];). 
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VOLCOPY OPTIONS 
-a__ Invoke a verification sequence requiring a positive operator response 
instead of the standard 10-second delay before the copy is made. 


-s_ Invoke the DEL/RUBOUT if wrong verification sequence (default). 
-y Answer "yes" to all questions. 
The following options are used only with tapes: 


-bpi density 
Bits-per-inch (i.e., 800/1600/3200/6250). This option is valid only for 
magnetic tapes. 


-feet size 
Size of reel in feet (i.e., use 1200 or 2400 as appropriate). This option is 
valid only for magnetic tapes. 


-reel num 
Beginning reel number for a restarted copy. 


-capacity blocks 
Tape cartridge capacity in 512 byte blocks. This option is not valid for 
magnetic tape. For streaming tapes, only valid streaming tape capacities can 
be entered. 


-block size 
Set the transfer block size to the number of physical blocks ( 512 bytes ). 
Note that an arbitrary block size might or might not work on a given 
system. Also, the block size read from the header of an input tape silently 
overrides this. Default is 8 for streaming tape or when capacity option is 
used. 


Default -block values when -bpi option is used: 


U 5000/30/35/50/55 

bpi block default 
6250 50 

3200 88 

1600 88 

800 88 


NOTE: With higher density streaming tapes ( > 60 MB ) the -bpi and the -feet 
options only permit the user to put 60 MB on tape. Use the -c option to 
use the greater tape density. 
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EXAMPLES 


To copy file system u3 on disk partition /dev/rdsk/cOd0s1 to a 9-track magnetic 
tape using the -bpi and -feet options, enter: 


/etc/volcopy -bpi 6250 -feet 2400 u3 /dev/rdsk/c0d0s1 voll /dew/rmt/Ohyy vola 


To copy file system root on disk partition /dev/rdsk/c0d0s1 to a 60 MB streaming 
tape using the -capacity option, enter: 


/etc/volcopy -capacity 113906 root /dev/rdsk/cOd0s1 pk5 /dev/rtp pk12 


To copy file system u5 on disk partition /dev/rdsk/cOd0s2 to a 150 MB streaming 
tape using the -capacity and -block options, enter: 


/etc/volcopy -capacity 284765 -block 32 u5 /dev/rdsk/cOd0s2 - /dev/rtp 


In the following examples, dashed volume arguments mean " use label that is 
there." Also, the -block option changes the transfer block size from the 
recommended default 32 to 16. 


To restore file system root from streaming tape to disk partition 
/dev/rdsk/c0d0s1, enter: 


/etc/volcopy root /dev/rtp - /dev/rdsk/c0d0s!1 - 


NOTE: Earlier releases of volcopy are not able to read a tape if it was written 
using the -block option with a value that was not a multiple of 8. 


To restore file system u3 from magnetic tape to disk partition /dev/rdsk/c0d0s1, 
enter: 


/etc/volcopy u3 /dev/rmt/Ohyy - /dev/rdsk/c0d0s1 - 


To copy file system accts from disk partition /dev/rdsk/cOd0s1 to disk partition 
/dev/rdsk/c0d1s1, enter: 


/etc/volcopy accts /dev/rdsk/c0d0s1 - /dev/rdsk/cOdis1 - 


FILES 


/etc/log/filesave.log a record of file systems/volumes copied 


SEE ALSO 


sh(1) in the User’s Reference Manual 
fs(4) in the Programmer’s Reference Manual 


UP-14805 Page 3 


VOLCOPY (1M) 


RESTRICTIONS 
Only device names beginning /dev/rtp/ are treated as tapes. 


Tape capacity remains at the value determined by volcopy. 


The /etc/volcopy and /etc/labelit command should only be performed on an 
unmounted file system even if in single-user mode. Using /etc/volcopy and 
/etc/labelit on a mounted file system can cause the file system to become 
unusable. 


Use only the yy node name when specifying the tape device with volcopy. 


Page 4 UP-14805 


WALL (1M) 


NAME 
oo” wall - write to all users 


SYNOPSIS 
/etc/wall [-g group] [infile] 


DESCRIPTION 
The command wall reads a message from either standard input until an end-of- 
file or from infile. It then sends this message to all currently logged in users. If 
the -g option is specified, the message is sent to all currently logged in users that 
belong to the group. The message is preceded by: 


Broadcast Message from... 
It is used to warn all users, typically prior to shutting down the system. 


The sender must be superuser to override any protections the users may have 
invoked [see mesg(1)]. 


FILES 


i /dev/tty* 


SEE ALSO 
mesg(1), write(1) in the User’s Reference Manual 


DIAGNOSTICS 
Cannot send fo ... 
The open on a tty file of a user failed. This could happen for several 
reasons such as incorrect permissions, a disconnected terminal, or an active 
shell layer session. 


RESTRICTIONS 
wall(1) fails to send its message on terminals running shell layers [see sh/(1)]. 
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NAME 
_wehrtbl - generate character classification and conversion tables for ASCII and 
supplementary code sets 


SYNOPSIS 
wehrtbl [file] 


DESCRIPTION 
The wchrtbl command creates tables containing information on character 
classification, character conversion, character set width, and numeric editing. 
The first table is a byte sized array encoded so that a table lookup can be used to 
determine the character classification of a character, to convert a character (see 
ctype(3C) and wctype(3W)), and to find the byte and screen width of a character 
in one of the supplementary code sets. The size of the array is (257*2) + 7 
bytes: 257 bytes are required for the 8-bit code set character classification table, 
257 bytes for the upper to lowercase and lower to uppercase conversion table, 
and 7 bytes for character set width information. The second table is 2 bytes long 
and is encoded so that the first byte specifies the decimal delimiter and the 
second byte, the thousand delimiter. If supplementary code sets are specified, 
additional variable sized tables are generated for multibyte character 
classification and conversion. 


The wchrtbl command reads the user-defined character classification and 
conversion information from file and creates three output files in the current 
directory. 


One output file, wetype.c (a C-language source file), contains the variable sized 
array generated from processing the information from file. Review the contents 
of wetype.c to verify that the array is set up as planned. The first 257 bytes of the 
array in wetype.c are used for character classification for single-byte characters. 
The characters used for initializing these bytes of the array represent character 
classifications that are defined in /usr/include/ctype.h; for example, L means a 
character is lowercase and _S!_B means the character is both a spacing 
character and a blank. The second 257 bytes of the array are used for character 
conversion. These bytes of the array are initialized so that characters for which 
you do not provide conversion information will be converted to themselves. 
When you do provide conversion information, the first value of the pair is stored 
where the second one would normally be stored, and vice versa. For example, if 
you provide <0x41 0x61>, then 0x61 is stored where 0x41 would normally be 
stored and 0x61 is stored where 0x41 would normally be stored. The last 7 bytes 
are used for character width information. Up to three supplementary code sets 
can be specified. 
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For supplementary code sets, there are three sets of tables. The first set is three 
pointer arrays which point to supplementary code set information tables. If the 
corresponding supplementary code set information is not specified, the contents 
of the pointers are zeros. The second one is a set of three supplementary code 
set information tables. Each table contains minimum and maximum code values 
to be classified and converted, and also contains pointers to character 
classification and conversion tables. If there is no corresponding table, the 
contents of the pointers are zeros. The last one is a set of character classification 
and conversion tables. Each table contains the same information as the single- 
byte table except that the codes are represented as process codes and the table 
size is variable. The characters used for initializing values of the character 
classification table represent character classifications that are defined in 
/usr/include/ctype.h and /usr/include/wetype.h. _E1 through ES are for 
international use and _E9 through E24 are for language dependent use. 


The second output file (a data file) contains the same information, but is 
structured for efficient use by the character classification and conversion 
routines; see ctype(3C) and wetype(3W). The name of this output file is the value 
of the character classification LC_CTYPE read in from file. This output file 
must be copied to the /lib/locale/locale/LC_CTYPE file by someone who is a 
superuser or a member of group bin. This file must be readable by user, group, 
and other; no other permissions should be set. To use the character classification 
and conversion tables on this file, appropriately set the LC_CTYPE category of 
setlocale(3C). 


The third output file (a data file) is created only if numeric editing information is 
specified in the input file. The name of the file is the value of the character 
classification LC_NUMERIC read from the file. This output file must be copied 
to the /lib/locale/locale/LC_NUMERIC file by someone who is a superuser or a 
member of group bin. This file must be readable by user, group, and other; no 
other permissions should be set. To use the numeric editing information on this 
file, appropriately set the LC_NUMERIC category of setlocale(3C). 


If no input file is given, or if the dash character (- argument is encountered, 
wchribl reads from standard input. 


The syntax of file allows the user to define the name of the data file created by 
wchrtbl, the assignment of characters to character classifications, the relationship 
between conversion letters, and byte and screen widths for up to three 
supplementary code sets. The keywords recognized by wchrtbl are: 
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cree et 


LC_CTYPE name of the first data file to be created by wchrtbl. 


c~ isupper character codes to be classified as uppercase letters. 
islower character codes to be classified as lowercase letters. 
| isdigit character codes to be classified as numeric. 
isspace character codes to be classified as spacing (delimiter) 
| characters. 
, ispunct character codes to be classified as punctuation characters. 
iscntrl character codes to be classified as control characters. 
isblank character codes for the space character. | 
isxdigit character codes to be classified as hexadecimal digits. 
ul relationship between conversion characters. 
cswidth byte and screen width information. 
r ( LC NUMERIC name of the second data file created by wehrtbl. 
numeric numeric editing information (decimal and thousand delimiters). 


LC_CTYPE1 specify that functions for specification of supplementary code 
set 1 follow. 


LC_CTYPE2 specify that functions for specification of supplementary code 
set 2 follow. 


LC_CTYPE3 specify that functions for specification of supplementary code 
set 3 follow. 


isphonogram (iswchar1) 
character codes to be classified as phonograms in 
supplementary code sets. 


isideogram (iswchar2) 
character codes to be classified as ideograms in supplementary 
code sets. 


i isenglish (iswchar3) 
character codes to be classified as English letters in 
supplementary code sets. 
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isnumber(iswchar4) 
character codes to be classified as numeric in supplementary t 
code sets. 


isspecial (iswcharS5) 
character codes to be classified as special letters in 
supplementary code sets. 


iswchar6 character codes to be classified as other printable letters in 
supplementary code sets. 


iswchar7 - iswchar8 
reserved for international use. 


iswchar9 - iswchar24 
character codes to be classified as language dependent 
letters/characters. 


The keywords iswchar1 through iswchar24 correspond to bit names _E1 through 
_E24 defined in wetype.h. 


Any lines with the pound sign (#) in the first column are treated as comments or 
and are ignored. Blank lines are also ignored. 


Characters for isupper, islower, isdigit, isspace, ispunct, iscntl, isblank, isxdigit, 
ul, isphonogram, isideogram, isenglish, isnumber, isspecial, and iswchar1- 
iswchar24 can be represented as hexadecimal or octal constants (for example, the 
letter a can be represented as 0x61 in hexadecimal or 0141 in octal) and must be 
up to two byte process codes. Hexadecimal and octal constants may be 
separated by one or more space and tab characters. 


The following is the format of an input specification for cswidth (byte widths for 
supplementary code sets 2 and 3 are exclusive of the single shift characters): 


n1{[:s1][,n2[:s2][,n3[:s3]]]] 


where values are: 

nl byte width for supplementary code set 1 
sl screen width for supplementary code set 1 

n2 __— byte width for supplementary code set 2 

s2 screen width for supplementary code set 2 
n3 byte width for supplementary code set 3 

s3 screen width for supplementary code set 3 
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a The following is the format of an input specification for numeric: 
di[d2] 


where values are: 

di decimal delimiter 

d2 thousand delimiter 

(di,d2 are represented by graphic characters) 


The dash character (-) may be used to indicate a range of consecutive numbers 
(inclusive of the characters delimiting the range). Zero or more space characters 
may be used for separating the dash character from the numbers. 


The backslash character (\) is used for line continuation. Only a carriage return 
is permitted after the backslash character. 


The relationship between conversion letters (ul) is expressed as ordered pairs of 

octal or hexadecimal constants: <converting-character converted-character > . 

These two constants must be up to two byte process codes and may be separated 

by one or more space characters. Zero or more space characters may be used 
i. for separating the angle brackets (< >) from the numbers. 


EXAMPLES 
The following is an example of an input file used to create the JAPAN code set 
definition table on a file named japan. 


LC_CTYPE japan 


# 

# specification for single-byte characters 
# 

isupper 0x41 - Ox5a 

islower Ox61 - Ox7a 

isdigit 0x30 - 0x39 

isspace Ox20 0x9 - Oxd 


ispunct 021 - Ox2f Ox3a - 0x40 \ 
Ox5b - 0x60 Ox7b - Ox7e 


isentrl OxO - Oxif Ox7f 
“™ isblank 0x20 
isxdigit 0x30 - 0x39 Ox61 - Ox66 0x41 - 0x46 
ul <0x41 Ox61> <0Ox42 0x62> <0x43 0x63> \ 


<0x44 0x64> <0x45 0x65> <0x46 0x66> \ 
<0x47 0x67> <0x48 0x68> <0x49 Ox69> \ 
<Ox4a Ox6a> <O0x4b Ox6b> <Ox4c Ox6c> \ 
<Ox4d Ox6d> <Ox4e Ox6e> <Ox4f Ox6f> \ 
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<0x50 Ox70> <0Ox51 0x71> <Ox52 0x72> \ 
<0x53 0x73> <0x54 0x74> <0x55 0x75> \ 
<0x56 0x76> <Ox57 Ox77> <0Ox58 0x78> \ 
<0x59 O0x79> <Ox5a Ox7a> 


cswidth Goel igee 
LC_NUMERIC num _japan 
numeric 

# 

# specification for supplementary code set 1 
# 

LC CTYPE! 

isupper Oxa3c1 - Oxa3da 

islower Oxa3e1 - oxa3fa 
isdigit Oxa3b0 - Oxa3b9 
isspace Oxatat 


isphonogram Oxa4ai - Oxa4f3 Oxa5ai - Oxadf6 

isideogram Oxb0a1 - OxbOfe Oxb1a1 - Oxbife Oxb2a1 - Oxb2fe \ 
Oxb3ai1 - Oxb3fe Oxb4ai1 - Oxb4fe Oxb5ai1 - Oxb5fe \ 
Oxb6a1 - Oxb6fe Oxb7ai - Oxb7fe Oxb8a1 - Oxb8fe \ 
Oxb9ai - Oxb9fe Oxbaai - Oxbafe Oxbba1 - Oxbbfe \ 
Oxbcai - Oxbcfe Oxbdai - Oxbdfe Oxbeai - Oxbefe \ 
Oxbfa1 - Oxbffe OxcOa1 - OxcOfe Oxctal - Oxcife \ 
Oxc2a1 - Oxc2fe Oxc3ai - Oxc3fe Oxc4ai - Oxc4fe \ 
Oxc5al - OxcSfe Oxc6al - Oxc6fe Oxc7ai - Oxc7fe \ 
Oxccai - Oxccfe Oxcdal - Oxcdfe Oxceai - Oxcefe \ 
Oxcfa1 - Oxcffe OxdOai - OxdOfe Oxdiai - Oxdife \ 
Oxd2a1 - Oxd2fe Oxd3ai - Oxd3fe Oxd4ai - Oxd4fe \ 
Oxd5a1 - Oxd5fe Oxd6ai - Oxd6fe Oxd7ai - Oxd7fe \ 
Oxd8ai - Oxd8fe Oxd9ai - Oxd9fe Oxdaai - Oxdafe \ 
Oxdba1 - Oxdbfe Oxdcai - Oxdcfe Oxddai - Oxddfe \ 
Oxdeai - Oxdefe Oxdfai - Oxdffe Oxe0ai - OxeOfe \ 
Oxeiai - Oxelfe Oxe2ai - Oxe2fe Oxe3ai - Oxe3fe \ 
Oxe4ai - Oxe4fe Oxe5al1 - Oxe5fe Oxe6ai - Oxe6fe \ 
Oxe7al - Oxe7fe Oxe8ai - Oxe8fe Oxe9ai - Oxe9fe \ 
Oxeaai - Oxeafe Oxeba1 - Oxebfe Oxecai - Oxecfe \ 
Oxeda1 - Oxedfe Oxeeai - Oxeefe Oxefai - Oxeffe \ 
Oxf0a1 - OxfOfe Oxfia1 - Oxfife Oxf2a1 - Oxf2fe \ 
Oxf3a1 - Oxf3fe Oxf4ai - Oxf4fe Oxf5ai - Oxf5fe \ 
Oxf6a1 - Oxf6fe Oxf7ai - Oxf7fe Oxf8ai - Oxf8fe \ 
Oxf9a1 - Oxf9fe Oxfaai - Oxfafe Oxfbai - Oxfbfe \ 
Oxfcai - Oxfcfe Oxfdai - Oxfdfe Oxfeai - Oxfefe \ 
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isenglish Oxa3c1 - Oxa3da Oxa3e1 - Oxa3fa 
c™~ isnumber Oxa3b0 - Oxa3b9 

isspecial Oxala2 - Oxatfe Oxa2a1 - Oxa2ae Oxa2ba - Oxa2c1 \ 
Oxa2ca - Oxa2d0 Oxa2dc - Oxa2ea Oxa2f2 - Oxa2f9 \ 
Oxa2fe Oxa8ai - Oxa8cO 

iswchar6 Oxa6ai - Oxa6b8 Oxa6c1 - Oxa6d8 Oxa7al - Oxa7c1 \ 
Oxa7d1 - Oxa7f1 

# 

# JIS X208 whole code set 

# 

iswchar9 Oxaial - Oxaife Oxa2a1 - Oxa2fe Oxa3a1 - Oxa3fe \ 


Oxa4al - Oxa4fe 
Oxa7a1 - Oxa7fe 
Oxaaal - Oxaafe 
Oxada1 - Oxadfe 
Oxb0a1 - OxbOfe 
Oxb3a1 - Oxb3fe 
Oxb6a1 - Oxb6fe 
Oxb9ai1 - Oxb9fe 
Oxbcea1 - Oxbcfe 


Oxa5a1 - Oxadfe 


Oxa8al - Oxa8fe 
Oxabai1 - Oxabfe 
Oxaeai - Oxaefe 
Oxb1ai - Oxbife 
Oxb4a1 - Oxb4fe 
Oxb7a1 - Oxb7fe 
Oxbaa1 - Oxbafe 
Oxbda1 - Oxbdfe 


Oxa6a1 - Oxa6fe \ 
Oxa9a1 - Oxa9fe \ 
Oxaca1 - Oxacfe \ 
Oxafa1 - Oxaffe \ 
Oxb2a1 - Oxb2fe \ 
Oxb5a1 - Oxb5fe \ 
Oxb8a1 - Oxb8fe \ 
Oxbba1 - Oxbbfe \ 
Oxbea1 - Oxbefe \ 


Oxbfa1 - Oxbffe OxcOa1 - OxcOfe Oxctai - Oxcife \ 


Oxc2a1 - Oxc2fe 
Oxc5a1 - Oxcdfe 
Oxc8ai - Oxc8fe 
Oxcba1 - Oxcbfe 
Oxceai - Oxcefe 
Oxdia1 - Oxdife 
Oxd4a1 - Oxd4fe 
Oxd7a1 - Oxd7fe 
Oxdaai - Oxdafe 
Oxdda1 - Oxddfe 
OxeOai - OxeOfe 
Oxe3a1 - Oxe3fe 
Oxe6al - Oxe6fe 
Oxe9ai - Oxe9fe 
Oxecai - Oxecfe 


Oxefa1 - Oxeffe Oxf0a1 - OxfOfe 


Oxc3a1 - Oxc3fe 
Oxc6a1 - Oxc6fe 
Oxc9a1 - Oxc9fe 
Oxccai - Oxccfe 


Oxc4a1 - Oxc4fe \ 
Oxc7a1 - Oxc7fe \ 
Oxcaa1 - Oxcafe \ 
Oxcda1 - Oxcdfe \ 


Oxcfa1 - Oxcffe OxdOa1 - OxdOfe \ 


Oxd2a1 - Oxd2fe 
Oxd5ai - Oxd5fe 
Oxd8ai - Oxd8fe 
Oxdba1 - Oxdbfe 
Oxdeai - Oxdefe 
Oxeiai - Oxetfe 
Oxe4ai - Oxe4fe 
Oxe7al - Oxe7fe 
Oxeaal - Oxeafe 
Oxedai - Oxedfe 


Oxd3a1 - Oxd3fe \ 
Oxd6a1 - Oxd6fe \ 
Oxd9a1 - Oxd9fe \ 
Oxdca1 - Oxdcfe \ 
Oxdfa1 - Oxdffe \ 
Oxe2ai - Oxe2fe \ 
Oxe5a1 - Oxe5fe \ 
Oxe8a1 - Oxe8fe \ 
Oxeba1 - Oxebfe \ 
Oxeeai - Oxeefe \ 


Oxfia1 - Oxfife \ 
Oxf4ai1 - Oxf4fe \ 
Oxf7a1 - Oxf7fe \ 
Oxfaa1 - Oxfafe \ 
Oxfda1 - Oxfdfe \ 


Oxf2a1 - Oxf2fe Oxf3ai1 - Oxf3fe 
| Oxf5a1 - Oxf5fe Oxf6ai - Oxf6fe 
| Oxf8a1 - Oxf8fe Oxf9a1 - Oxf9fe 
| Oxfbai - Oxfbfe Oxfcai - Oxfcfe 
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# 
# 
# 
iswehar10 
# 
# 
# 
iswchar11 
# 
# 
# 
iswcohar12 
& 
# 
# 
iswehar13 


+ tk tk 


Oxfeai - Oxfefe 


JIS X0208 parentheses 


Oxaic6 - Oxaidb 


JIS X0208 hiragana 


Oxa4al - Oxa4f3 


JIS X0208 katakana 


Oxa5ai - Oxa5f6 


JIS X0208 other characters 


Oxa6al - Oxa6b8 Oxa6c1 - Oxa6d8 Oxa7ai - Oxa7c1 \ 
Oxa7d1 - Oxa7fi Oxa8ai - Oxa8bf 


English letter translation table 


<Oxa3c1 Oxa3e1 > 
<Oxa3c4 Oxa3e4 > 
<Oxa3c7 Oxa3e7 > 
<Oxa3ca Oxa3ea > 
<Oxa3ced Oxa3ed > 
<Oxa3d0 Oxa3f0 > 
<Oxa3d3 Oxa3f3 > 
<Oxa3d6 Oxa3f6 > 
<0xa3d9 Oxa3f9 > 


<Oxa3c2 Oxa3e2 > 
<Oxa3c5 Oxa3e5 > 
<Oxa3c8 Oxa3e8 > 
<Oxa3cb Oxa3eb > 
<Oxa3ce Oxa3ee > 
<Oxa3d1 Oxa3f1 > 
<Oxa3d4 Oxa3f4 > 
<0xa3d7 Oxa3f7 > 
<Oxa3da Oxa3fa > 


kana translation table 


<0Oxa4a1 Oxa5ai1 > 
<Oxa4a4 Oxa5a4 > 
<Oxa4a7 0Oxa5a7 > 
<Oxa4aa Oxa5aa > 
<Oxa4ad Oxa5ad > 
<Oxa4b0 Oxa5b0 > 
<0xa4b3 Oxa5b3 > 
<Oxa4b6 Oxa5b6 > 


<Oxa4a2 Oxa5a2 > 
<0Oxa4a5 Oxa5a5 > 
<Oxa4a8 Oxa5a8 > 
<Oxa4ab Oxa5ab > 
<QOxa4ae Oxa5ae > 
<0Oxa4b1 Oxa5b1 > 
<0xa4b4 Oxa5b4 > 
<0xa4b7 Oxa5b7 > 


<Oxa3c3 Oxa3e3> \ 
<Oxa3c6 Oxa3e6> \ 
<Oxa3c9 Oxa3e9> \ 
<Oxa3cc Oxa3ec> \ 
<Oxa3cf Oxa3ef> \ 
<Oxa3d2 Oxa3f2> \ 
<Oxa3d5 Oxa3f5> \ 
<Oxa3d8 Oxa3f8> \ 


\ 


<0xa4a3 Oxa5a3> \ 
<Oxa4a6 Oxa5a6> \ 
<Oxa4a9 Oxa5a9> \ 
<Oxa4ac Oxa5ac> \ 
<Oxa4af Oxa5af> \ 
<Oxa4b2 Oxa5b2> \ 
<0xa4b5 Oxa5b5> \ 
<0xa4b8 Oxa5b8> \ 
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<0xa4b9 Oxa5b9> <Oxa4ba Oxa5Sba> <Oxa4bb OxaSbb> \ 
<Oxa4bc Oxa5be> <Oxa4bd Oxa5bd> <Oxa4be OxaSbe> \ 
<0xa4c0 Oxa5cO> <Oxa4e1 Oxa5c1> \ 


<Oxa4bf OxaSbf> 
<Oxa4e2 Oxa5c2 > 
<Oxa4c5 Oxa5c5 > 
<Oxa4c8 0xa5c8 > 
<Oxa4cb Oxa5cb > 
<Oxa4ce Oxa5dce > 
<Oxa4d1 Oxa5d1 > 
<Oxa4d4 Oxa5d4 > 
<Oxa4d7 Oxa5d7 > 
<Oxa4da Oxa5da > 
<Oxa4dd Oxa5dd > 
<Oxa4e0 Oxa5e0 > 
<Oxa4e3 Oxa5e3 > 
<Oxa4e6 Oxa5e6 > 
<Oxa4e9 Oxa5e9 > 
<Oxa4ec Oxa5ec > 


<Oxa4c3 0xa5c3 > 
<Oxa4c6 Oxa5c6 > 
<0Oxa4c9 Oxa5c9 > 
<Oxa4cc Oxa5cc > 


<Oxa4c4 Oxa5c4> \ 
<Oxa4c7 Oxa5c7> \ 
<Oxa4ca Oxa5ca> \ 
<Oxa4ed Oxa5ced > \ 


<Oxa4cf OxaScf> <Oxa4d0 Oxa5d0> \ 


<Oxa4d2 Oxa5d2> 
<0Oxa4d5 Oxa5d5 > 
<0xa4d8 Oxa5d8 > 
<Oxa4db Oxa5Sdb > 
<Oxa4de Oxa5de > 
<Oxa4e1 Oxa5e1 > 
<Oxa4e4 Oxa5e4 > 
<Oxa4e7 Oxade7 > 
<Oxa4ea Oxa5ea > 
<Oxa4ed Oxa5ed > 


<Oxa4d3 Oxa5d3> \ 
<Oxa4d6 Oxa5d6> \ 
<Oxa4d9 Oxa5d9> \ 
<Oxa4de Oxa5de> \ 
<Oxa4df Oxa5df> \ 
<Oxa4e2 Oxa5e2> \ 
<Oxa4e5 Oxa5e5> \ 
<Oxa4e8 Oxa5e8> \ 
<Oxa4eb Oxa5eb> \ 
<Oxa4ee Oxa5ee> \ 


<Oxa4ef Oxa5ef> <Oxa4f0 Oxa5f0> <Oxad4fi Oxa5f1> \ 
<Oxa4f2 Oxa5f2> <Oxa4f3 Oxadf3 > 


# 

# specification for supplementary code set 2 
# 

LC_CTYPE2 

iswchar6 Oxai - Oxdf 

iswehar14 Oxal - Oxdf 


FILES 

USTRENOGaI OTL e= CTYPE 
data files containing character classification and conversion 
tables and character set width information created by chrtbl or 
wehrtbl. 

/usr/lib/locale/locale/LC_NUMERIC 
data files containing numeric editing information. 

/usr/include/ctype.h 
header file containing information used by character 
classification and conversion routines for single byte 
characters. 
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/usr/include/wctype.h 
header file containing information used by international 
character classification and conversion routines for 
supplementary code sets. 

/usr/include/xctype.h 
header file containing information used by language 
dependent character classification and conversion routines for 
supplementary code sets. 


SEE ALSO 
ctype(3C), wctype(3W), setlocale(3C), environ(5) in the Programmer’s Reference 
Manual 
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NAME 
whodo - who is doing what 


SYNOPSIS 
/etc/whodo 


DESCRIPTION 
The command whodo produces formatted and dated output from information in 
the /etc/utmp and /etc/ps_data files. 


The display is headed by the date, time and machine name. For each user logged 
in, device name, user-ID and login time is shown, followed by a list of active 
processes associated with the user-id. The list includes the device name, process- 
id, cpu minutes and seconds used, and process name. 


EXAMPLES 
The command: 
whodo 
produces a display like this: 


Tue Mar 12 15:48:03 1985 
bailey 


ttyO9 mcn 8:51 
ttyO9 28158 0:29 sh 


ttyS2 bdr 15:23 
ttyS2 21688 0:05 sh 
ttyS2 22788 0:01 whodo 
ttyS2 22017 0:03 u 
ttyS2 22549 0:01 sh 


xt162 lee 10:20 
tty08 6748 0:01 layers 
xt162 6751 0:01 sh 
xt163 6761 0:05 sh 
tty08 6536 0:05 sh 
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FILES 
/etc/passwd 
/etc/ps_data 
/etc/utmp 


SEE ALSO 
ps(1), who(1) in the User’s Reference Manual 
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NAME 
o™ intro - introduction to special files 


DESCRIPTION 
This section describes various special files that refer to specific hardware 
peripherals, and UNIX system device drivers. STREAMS [see intro(2)] software 
drivers, modules and the STREAMS-generic set of iocti(2) system calls are also 
described. 


For hardware related files, the names of the entries are generally derived from 
names for the hardware, as opposed to the names of the special files themselves. 
Characteristics of both the hardware device and the corresponding UNIX system 
device driver are discussed where applicable. 


Disk device file names are in the following format: 
/dev/{r} dsk/c# d#s# 


where r indicates a raw interface to the disk, the c# indicates the controller 
~~ number, d# indicates the device attached to the controller and s# indicates the 
! section number of the partitioned device. 


SEE ALSO 
"Disk/Tape Management" in the Administration Guide 
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| NAME 
— clone - open any minor device on a STREAMS driver 


DESCRIPTION 
The command clone is a STREAMS software driver that finds and opens an 
unused minor device on another STREAMS driver. The minor device passed to 
clone during the open is interpreted as the major device number of another 
STREAMS driver for which an unused minor device is to be obtained. Each 
such open results in a separate stream to a previously unused minor device. 


The clone driver consists solely of an open function. This open function performs 
all of the necessary work so that subsequent system calls [including close(2)] 
require no further involvement of clone. 


clone generates an ENXIO error, without opening the device, if the minor device 
number provided does not correspond to a valid major device, or if the driver 
indicated is not a STREAMS driver. 


CAVEATS 
fA Multiple opens of the same minor device cannot be done through the clone 
interface. Executing stat(2) on the file system node for a cloned device yields a 
different result from executing fstat(2) using a file descriptor obtained from 
opening the node. 


SEE ALSO 


log(7) 
STREAMS Programmer’s Guide 


UP-14805 Page 1 
nn Fe 8 ee 


CLONE (7) 


[This page left blank.] 


Page 2 UP-14805 


DUAL-HPSIO(7) 


NAME 
-_' dual-hpsio - high performance serial I/O module 


DESCRIPTION 
The dual-hpsio module provides 16 asynchronous interfaces and two parallel 
interfaces. Each line attached to the asynchronous ports behaves as described in 
termio(7). 


The performance gain is in total system performance because all the functions 
described in termio(7), in addition to inservice diagnostics, are performed by the 
hpsio microprocessor. This frees the main processor of the system to perform 
other tasks. 


dual-hpsio has two sets of 128 kilobytes of RAM (i.e. one for each hpsio) that 
must be loaded with its operating software at the start of day; see /dhpsio(1M). 
It also must be reloaded with its operating software when a power failure or a 
fatal error has occurred such as a bus error, unexpected interrupt, or a memory 
parity error. After reloading the operating software, the operating system 

as reissues all outstanding commands to the dual-hpsio so all the processes using the 
ports on the dual-hpsio resume normal operation. 


All characters buffered on the dual-hpsio at the time of the failure are lost. 


Input and output for each asynchronous line may independently be set to run at 
any speed except the 50, 200, and EXTB speeds. 


FILES 
/dev/hp 
/dev/tty 
/dev/lp 


SEE ALSO 
Idhpsio(1M), termio(7) 
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NAME 
err - error-logging interface 


DESCRIPTION 
Minor device 0 of the err driver is the interface between a process and the system 
error-record collection routines. 


The driver may be opened for reading or writing by a process with superuser 
permissions. 


Each read causes an entire error record to be retrieved; the record is truncated if 
the read request is for less than the record length. 


FILES 
/dev/error special file 


SEE ALSO 
errdemon(1M) 
errfile(4) in the Programmer’s Reference Manual 
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NAME 
hpmsc - high performance mass storage controller module 


DESCRIPTION 
The Apmsc module supports peripherals which use the Small Computer System 
Interface (SCSI). The Apmsc module supports both external SCSI (differential) 
and internal SCSI (single-ended) interfaces. 


An error record for controller failures is sent to /dev/error for error logging. 


FILES 
/dev/fdsk/... 
/dev/rmt/... 
/dev/dsk/... 
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NAME 
hpsio - high performance serial I/O module 


DESCRIPTION 
The hpsio module provides eight asynchronous interfaces and one parallel 
interface. Each line attached to the asynchronous ports behaves as described in 
termio(7). The parallel interface is used for printers and behaves as described in 


ip(7). 


The performance gain is in total system performance because all the functions 
described in termio(7) and /p(7), in addition to inservice diagnostics, are 
performed by the hpsio microprocessor. This frees the main processor of the 
system to perform other tasks. 


hpsio has 128 kilobytes of RAM that must be loaded with its operating software 
at the start of day; see /dhpsio(1M). It also must be reloaded with its operating 
software when a power failure or a fatal error has occurred such as a bus error, 
unexpected interrupt, or a memory parity error. After reloading the operating 
software, the operating system reissues all outstanding commands to the hpsio so 
all the processes using the ports on the hpsio resume normal operation. 


All characters buffered on the Apsio at the time of the failure are lost. 
Input and output for each asynchronous line may independently be set to run at 
any speed except the 50, 200, and EXTB speeds. 


FILES 
/dev/hp 
/dev/tty 
/dev/lp 


SEE ALSO 7 
Idhpsio(1M), termio(7) 
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NAME 
id - Integral Disk Subsystem 


DESCRIPTION 
The integral disk subsystem may consist of one or more units. The files 
/dev/dsk/c0dns0 ... /dev/dsk/cOdnsx refer to sections of the drive unit number n. 
This slicing allows the media to be broken up into more manageable pieces - up 
to x pieces, depending on drive size. 


The /dev/dsk files provide access to the disk by means of the system’s normal 
buffering mechanism. There is also a "raw" interface which provides for direct 
transfer of a specified number of bytes between the disk and a location in the 
user’s address space. The names of the raw disk files begin with /dev/rdsk and 
end with a number which selects the same disk section as the corresponding 
/dev/dsk file. In raw I/O the read or write must begin on a word boundary, 
transfer counts can be as small as a single byte. 


FILES 
/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 
Administration Guide 
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NAME 
om ios - intelligent 8-channel serial I/O interface 


DESCRIPTION 
Each line attached to an ios port behaves as described in termio(7). 


Input and output for each line may independently be set to run at any speed 
except the 200 and EXTB speeds; see fermio(7) for setting the speed. 


The IXON flag for output control described in termio(7) does not always work 
as quickly as desired because ios is a buffered output device. 


The output buffer must be flushed before the output can be stopped. 


FILES 
/dev/tty 


SEE ALSO 
termio(7) 
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NAME 
o™ kbd - generalized string translation module 


DESCRIPTION 
The STREAMS module kbd is a programmable string translation module. It can 
perform two types of operations on an input stream: the first type is simple 
byte-swapping by means of a lookup table; the second is string translation. It is 
useful for code set conversion and compose-key or dead-key character 
production on terminals and production of overstriking sequences on printers. It 
may also be used for minor types of key-rebinding, expansion of abbreviations, 
and keyboard rearrangement (an example of the latter would be swapping the 
positions of the Y and Z keys required for German keyboards, or providing 
Dvorak keyboard emulation for QWERTY keyboards). The manual entry 
kbdcomp(1M) discusses table construction and the input language and contains 
sample uses. This document is intended mainly to aid administrators in 
configuring the module on a particular system; the user interface to the module is 
solely through the commands kbdload(1M) and kbdset(1M). 


a The kbd module works by modifying an input stream according to instructions 

| embodied in tables. It has no built-in default tables. Some tables may be loaded 
when the system is first brought up by pushing the module and loading standard 
or often-used tables [see kbdload(1M)] which are retained in main memory 
across invocations and made available to all users. These are called public tables. 
Users may also load private tables at any time. Private tables do not remain 
resident. 


With kbdset(1) users may query the module for a list of available and attached 
tables; attach various tables; and set the optional per-user hot key, hot key mode, 
and verbose string for their particular invocations. 


When a user attaches more than one table, the user’s hot key may be used to 
cycle to the next table in the list. If only one table is specified, the hot key may 
be used to toggle translation on and off. When multiple tables are in use, the hot 
key may be used to cycle through the list of tables. [See kbdset(1) for a 
description of the available modes.] 


In its initial state, kbd scans input for occurrences of bytes beginning a translation 
f~ sequence. Upon receiving such a byte, it attempts to match subsequent bytes of 
| the input to programmed sequences. Input is buffered beginning with the byte 
which caused the state change and is released if a match is not found. When a 
match fails, the first byte of the invalid sequence is sent upstream, the buffered 
input is shifted, and the scan begins again with the resulting input sequence. If 
the current table contains an error entry, its value (one or more bytes) is 
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substituted for the offending input byte. When a sequence is found to be valid, 
the entire sequence is replaced with the result string specified for it. 


The kbd module may be used in either the read or write directions, or in both Oo 
simultaneously. Maps and hot keys may be specified independently for input and 
output. 

RESTRICTIONS 


It is not an error to attach multiple tables without defining a hot key, but the 
tables will not all be accessible. It 1s recommended that the user’s hot key be set 
before loading and attaching tables to avoid unpleasant side effects when an 
unfamiliar arrangement is first loaded. 


Each user has a limitation on the amount of memory that may be used for private 
and attached tables. This quota is controlled by the variable kbd_umem 
described later. When a user who is not the superuser attempts to load a table 
or create a composite table, the quota is checked, and the load fails if it causes 
the quota to be exceeded. When a composite table is attached, the space for 
attachment (which requires more space than the composite table itself) is 
charged against this quota. Attachment of simple tables is not charged against 
the quota. The quota is enforced only when loading new tables. Detaching , 
temporarily from unneeded composite tables may reduce the current allocation 
enough to load a table that would otherwise fail due to quota enforcement. To 
minimize chances of failure while loading tables, it is advisable to load all 
required tables and make all required composite tables before attaching any of 
them. 


In releases prior to System V Release 4.0, kbd uses the module STRAL to 
allocate storage for tables. In subsequent releases it does not. If STRAL is 
required, it should be installed by the normal installation process. If any 
undefined external errors for STRAL functions (salloc, sfree) are seen when 
rebuilding the UNIX system kernel, this is an indication that the STRAL module 
is needed but not present, and kbd may not be used. 


CONFIGURATION PARAMETERS 
The master (or space.c) file contains some configurable parameters. #C (or 
NCONF if using a space.c file) is the number of modules configured and defines ™ 
the total number of simultaneous users. This provides for #C users with one- or } | 
two-way mapping. Ww 


NKBDU is the maximum number of tables that may be attached by a single user. 
The number should be enough to cover uncommon cases, but must be at least 
two. The default is six. 
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ZUMEM, from which the variable kbd_umem is assigned, is the maximum 
number of bytes that a user (other than the superuser) may have allocated to 
private tables (i.e., the quota). The default is 4096. 


Releases that require the STRAL module for allocation have the additional 
variable AMEM, from which kbd_amem is set. This variable controls the size of 
the initial pool from which tables and some internal structures are allocated. The 
default is 22528. 


KBDTIME is the default timer value for timeout mode. It is the number of clock 
ticks allowed before timing out. The value of one clock tick depends on the 
hardware, but is usually 1/100 or 1/60 of a second. A timeout value of 20 is 1/5 
second at 100 Hz; a value of 12 produces a 1/5 second timeout at.60 Hz. Values 
from 5 to 400 inclusive are allowed by the module; if the value set by KBDTIME 
is outside this range, the module forces it to the nearest limit. (This value is only 
a default; users may change their particular Stream to use a different value 
depending on their own preference, terminal baud-rate, and typing speed.) 


BUGS 


NULL characters may not be used in result or input strings, because they are 
used as string delimiters. 


You should be able to obtain information on timeout values of currently attached 
tables, and be able to reset value more easily. 


FILES 


/usr/lib/kbd - directory containing system standard table files. 
/usr/lib/kbd/sre - source for some system table files. 


SEE ALSO 


kbdcomp(1M), kbdload(1M) 
kbdset(1) in the User’s Reference Manual 
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NAME 
cn log - interface to STREAMS error logging and event tracing 


DESCRIPTION 
The device driver Jog is a STREAMS software device driver that provides an 
interface for the STREAMS error logging and event tracing processes 
[strerr(1M), strace(1M)]. log presents two separate interfaces: a function call 
interface in the kernel through which STREAMS drivers and modules submit log 
messages; and a subset of ioctl(2) system calls and STREAMS messages for 
interaction with a user level error logger, a trace logger, or processes that need to 
submit their own Jog messages. 


Kernel Interface 
log messages are generated within the kernel by calls to the function strlog: 


strlog(mid, sid, level, flags, fmt, arg], ...) 
short mid, sid; 
char level; 
~~ ushort flags; 
char *fmt; 
unsigned arg]; 


Required definitions are contained in <sys/strlog.h> and <sys/log.h>. mid is 
the STREAMS module ID number for the module or driver submitting the log 
message. sid is an internal sub-ID number usually used to identify a particular 
minor device of a driver. Jevel is a tracing level that allows for selective screening 
out of low priority messages from the tracer. flags are any combination of 
SL_ERROR (the message is for the error logger), SL_TRACE (the message is 
for the tracer), SL_ FATAL (advisory notification of a fatal error), and 
SL_NOTIFY (request that a copy of the message be mailed to the system 
administrator). fmt is a printf(3S) style format string, except that %s, %e, %E, 
%g, and %G conversion specifications are not handled. Up to NLOGARGS 
(currently 3) numeric or character arguments can be provided. 


User Interface 

log is opened using the clone interface, /dev/log. Each open of /dev/log obtains a 
£™ separate stream to log. In order to receive Jog messages, a process must first 

notify Jog whether it is an error logger or trace logger using a STREAMS I_STR 

ioctl call (see below). For the error logger, the L_STR ioctl has an ic_cmd field 

of I ERRLOG, with no accompanying data. For the trace logger, the ioctl has 

an ic_cmd field of I TRCLOG, and must be accompanied by a data buffer 

containing an array of one or more struct trace_ids elements. Each trace_ids 
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structure specifies an mid, sid, and level from which message is accepted. strlog 
accepts messages whose mid and sid exactly match those in the trace_ids 
structure, and whose level is less than or equal to the level given in the trace_ids 
structure. A value of -1 in any of the fields of the trace_ids structure indicates 
that any value is accepted for that field. 


At most one trace logger and one error logger can be active at a time. Once the 
logger process has identified itself using the ioctl call, Jog begins sending up 
messages subject to the restrictions noted above. These messages are obtained 
using the getrnsg(2) system call. The control part of this message contains a 

log ctl structure, which specifies the mid, sid, level, flags, time in ticks since boot 
that the message was submitted, the corresponding time in seconds since Jan. 1, 
1970, and a sequence number. The time in seconds since 1970 is provided so 
that the date and time of the message can be easily computed, and the time in 
ticks since boot is provided so that the relative timing of Jog messages can be 
determined. 


Different sequence numbers are maintained for the error and trace logging 
streams, and are provided so that gaps in the sequence of messages can be 
determined (during times of high message traffic some messages may not be 
delivered by the logger to avoid hogging system resources). The data part of the 

_message contains the unexpanded text of the format string (null terminated), 
followed by NLOGARGS words for the arguments to the format string, aligned 
on the first word boundary following the format string. 


A process may also send a message of the same structure to Jog, even if it is not 
an error or trace logger. The only fields of the log ctl structure in the control 
part of the message that are accepted are the level and flags fields; all other 
fields are filled in by /og before being forwarded to the appropriate logger. The 
data portion must contain a null terminated format string, and any arguments (up 
to NLOGARGS) must be packed one word each, on the next word boundary 
following the end of the format string. 


Attempting to issue an 1 TRCLOG or I ERRLOG when a logging process of 
the given type already exists results in the error ENXIO being returned. 
Similarly, ENXIO is returned for 1 TRCLOG ioctls without any trace_ids 
structures, or for any unrecognized I_STR ioctl calls. Incorrectly formatted log 
messages sent to the driver by a user process are silently ignored (no error 
results). 
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EXAMPLES 
rf” Example of I ERRLOG notification: 


struct strioctl ioc; 
ioc.ic cmd = I ERRLOG; 
ioc.ic timout = 0; /* default timeout (15 secs.) */ 
ioc.ic len = 0; 
ioc.ic dp = NULL; 
ioctl(log, I STR, &10c); 
Example of I TRCLOG notification: 


struct trace ids tid[2]; 


tid[0].ti_mid = 2; 
tid[O].ti_sid = 0; 

TaN tid[0].ti_level = 1; 

, | tid{1].ti_ mid = 1002; 
tid[1].ti_sid = -1;  /* any sub-ID is allowed */ 
tid[1].ti_level = -1; /* any level is allowed */ 
ioc.ic cmd = I TRCLOG; 
i0c.ic_ timout = 0; 
ioc.ic len = 2 * sizeof(struct trace_ids); 
ioc.ic dp = (char *)tid; 
ioctl(log, I STR, &ioc); 


Example of submitting a Jog message (no arguments): 


struct strbuf ctl, dat; 
struct log ctl Ic; 
char *message = "pick up some milk on the way home"; 


ctllen = ctlmaxlen = sizeof(Ic); 
cf ctl.buf = (char *)&lc; 


dat.len = dat.maxlen = strlen(message); 
dat.buf = message; 
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Ic level = 0; 
Icflags = SL_ERROR|SL NOTIFY; 


putmsg(log, &ctl, &dat, 0); 


FILES 
/dev/log 
< sys/log.h> 
< sys/strlog.h > 


SEE ALSO 
strace(1M), strerr(1M), clone(7) 


intro(2), getmsg(2), putmsg(2) in the Programmer’s Reference Manual 
STREAMS Programmer’s Guide 
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NAME 
Ip — parallel printer interface 


DESCRIPTION 
Ip is an interface to the parallel printer channel. Bytes written are sent to the printer. 
Opening and closing produce page ejects. Unlike the serial interfaces (termio(7)), 
the /p driver never prepends a carriage retum to a newline (line feed). The /p driver 
does have options to filter output, for the benefit of printers with special require- 
ments. The driver also controls page format. Page format and filter options are con- 
trolled with toctl(2): 


#include <sys/lprio.h> 


ioctl(fildes, command, arg) 


where command is one of the following constants: 


LPRGET Get the current page format and put it in the Iprio structure pointed to 
by arg. 
LPRSET Set the current page format from the location pointed to by arg; this 


location is a structure of type Iprio, declared in the header file: 


struct: ipric 4 
short ind; 
short col; 
short line; 

}; 

arg should be declared as follows: 


struct lprio *arg; 


ind is the page indent in columns, initially 4. col is the number of columns in a line, 
initially 132, line is the number lines on a page, initially 66. A newline that extends 
over the end of a page is output as a formfeed. Lines longer than the line length 
minus the indent are truncated. 


LPRSOPTS _ Set the filter options from arg, which must be of type int. arg should 
be the logical or of one or more of the following constants, defined in 
the header file: 
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Constant 


LPNOBS 


LPRAW 


LPCAP 


LPNOCR 


LPNOFF 


LPNONL 
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Value 


16 


32 


128 


Meaning 


No back space. Set this bit if the printer 
cannot properly interpret backspace charac- 
ters. The driver uses carriage return to pro- 
duce equivalent overstriking. 


Raw output. Set this bit if the driver must 
not edit output in any way. The driver 
ignores all other option bits. 


Capitals. This option supports printers with 
a ‘‘half-ASCI’’ character set. Lowercase is 
translated to uppercase. The following spe- 
cial characters are translated: { to €, } to; 
~ to =; | to 4; ~ to A. 


No Carnage Retum. This option supports 
printers that do not respond to a carriage 
return (character 0D hexadecimal). Car- 
riage returns are changed to newlines. If 
No Newline is also set, carriage returns are 
changed to form feeds. 


No Form Feed. This option supports 
printers that do not respond to a form feed 
(character 0C hexadecimal). Form Feeds 
are changed to newlines. If No Newline is 
also set, form feeds are changed to carriage 
returns. 


No Newline. This option supports printers 
that do not respond to a newline (character 
0A hexadecimal). Newlines are changed to 
carriage returns. If No Carriage Return is 
also set, newlines are changed to form 
feeds. 
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i  ————— 


LPRGOPTS Return the current state of the filter options. 
rn Note that once set, options will remain intact through a close. 


FILES 
/dev/p? 


SEE ALSO 
Ipset( 1M) 
Ipr(1) in the User’s Reference Manual 
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NAME 
m68881 - M68881 Hardware Floating Point Coprocessor 


DESCRIPTION 
The M68881 floating point coprocessor is a full implementation of the IEEE 
Standard for Floating Point Arithmetic (P754). It is designed to operate as a 
coprocessor to the M68020 processor on Unisys systems and provides a logical 
extension to the M68020 instruction set and registers. 


A set of 8 floating point data registers and 46 instructions are added that are 
conceptually similar to the integer data registers and functions of the M68020 
processor, and so appear to be fully integrated to the programmer. All 
addressing modes of the M68020 are supported for data references. 


The M68881 is a non-DMA-type coprocessor that communicates with the 
M68020 using the general purpose coprocessor interface. As the M68020 is used 
to decode and fetch operands, all addressing modes of the M68020 are supported 
with the same handling of addressing exceptions for standard instructions. 


See Motorola publication Mc68881UM/AD for more information. 


KERNEL SUPPORT 
Several kernel enhancements make using the M68881 in a multiuser environment 
possible. 


As it is a shared hardware resource, the M68881’s state is saved and restored on 
context switches from the user structure so that several users can use the M68881 
concurrently. The M68881’s internal state, user registers, and control registers 
make up the complete state for a given user. The state is saved in each user 
structure. 


In addition, the M68881’s state is saved on power down and restored on power 
up when a powerfail/recovery cycle occurs. This is necessary as the M68881 iS 
reset on power up like the M68020. 


The kernel also must recognize and handle exception traps from the M68881 for 
each of the 7 detectable exceptions. All user mode exceptions are mapped to the 
floating point exception signal. The status register can be used to determine the 
specific type of exception when the signal is received. No system mode 
exceptions from the M68881 are allowed. 


The coprocessor causes an M68020 exception if it detects a control message from 
the M68020. This new exception, Coprocessor Protocol Violation, is mapped to 
the illegal instruction signal if caused in user mode. 
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LANGUAGE SUPPORT 
The C compiler generates inline hardware floating point instructions and 
allocates register double and float variables to the M68881 floating point data WwW 
registers. 


C LIBRARY ROUTINES 
#inc lude <sys/fpu.h> 
int rd881_ status ( ) 
int rd881_iaddr ( ) 
int rd881_ control ( ) 
void wr881 control (x) 
int x; 


rd881_status, rd881_iaddr, and rd881_control allow the C programmer to access 
the M68881’s control and status registers. The FPSR, FPIAR, and FPCR 
register values are read respectively from the M68881 and returned as integers. 


wr881_ control writes the value x to the M68881’s control register. 


These functions are useful for determining the error status after executing an 

instruction on the M68881, and for setting up the rounding mode and trap ee 
enabler state for an application. The include file sys/fpu.h contains defines for 

testing the status bits or changing the control mode. 


The functions are careful not to change the M68881 status flags when moving the 
status information. 


MATH LIBRARY ROUTINES 
#include <math.h> 
#include <sys/fpu.h> 


int acos881 (x,result) 
int asin881 (x,result) 
int atan881 (x,result) 
int cos881 (x,result) 
int cosh881 (x,result) 
int etox881 (x,result) 
int log881 (x,result) | 
int logn881 (x,result) Ww 
int sin881 (x,result) 
int sinh881 (x,result) 
int sqrt881 (x,result) 
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int tan881 (x,result) 
int tanh881 (x,result) 


double x; 
double *result; 


All of the above functions return the M68881 FPSR status register flags to 
determine what error conditions may have occurred during the operation. 


These functions are intended for the C programmer who wants to use the 
instructions of the M68881 through a streamlined interface. Note that unlike the 
standard math library functions, all error detection and handling is up to the 
user. | 

The return value is the accumulative set of bits set in the M68881 FPSR status 
register after each M68881 instruction is executed. The include file sys/fpu.h 
contains defines for testing the status bits returned. 


RESTRICTIONS 
None. 


SEE ALSO 
cc(1), £77(1), adb(1), sdb(1), as(1) in the Programmer’s Reference Manual 
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NAME 
mem, kmem - core memory 


DESCRIPTION 
The file /dev/mem is a special file that is an image of the core memory of the 
computer. It may be used, for example, to examine, and even to patch the 
system. 


Byte addresses in /dev/mem are interpreted as memory addresses. References to 
non-existent locations cause errors to be returned. 


Examining and patching device registers is likely to lead to unexpected results 
when read-only or write-only bits are present. 


The file /dev/kmem is the same as /dev/mem except that kernel virtual memory 
rather than physical memory is accessed. 


FILES 
/dev/mem 


/dev/kmem 


WARNINGS 
Some of /dev/kmem cannot be read because of write-only addresses or 
unequipped memory addresses. 
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NAME 


nec - NEC Multi-protocol Serial Controller (7201) 


DESCRIPTION 


The nec provides two asynchronous ports that behave as described in termio(7). 


Input and output for each line may independently be set to run at any speed 
except the EXTB speed. 


There are two notable hardware differences between the nec and other system 
asynchronous controllers. The nec frames two NUL characters when a break is 
received, one at the beginning of the break and one at the end of the break. The 
nec does not strip the parity bit of a received character when parity is enabled. 
The input mode flag ISTRIP must be used to prevent reading characters with the 
parity bit. 


Heavy use of these two ports has a serious adverse affect on the performance of 
the system. Other asynchronous ports should be used first. 


FILES 


/dev/ttya 
/dev/ttyb 


SEE ALSO 


termio(7) 
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NAME 
rr" net - Ethernet interface and control 


DESCRIPTION 
The Ethernet interface defines a message interface to an Ethernet driver 
implemented under STREAMS. This Stream provides a mechanism by which 
messages may be passed to the Ethernet driver from the consumer and vice 
versa. 


The Ethernet driver is a data link layer service. It is based on the definitions of 
the IEEE-802.3/Ethernet standard. 


The Stream message types that are used to communicate between the consumer 
and the Ethernet driver have the following format: 


* An M PROTO message block possibly followed by one or more M_DATA 
message blocks. The M PROTO message block contains the service 
primitive types and the relevant arguments associated with the primitives. 
The M DATA blocks contain any consumer data associated with the 


om service primitive. 
* An M PCPROTO message block containing the service primitive type and 
all relevant arguments associated with the primitive. 


The Ethernet interface consists of two phases of communication: 
initialization/deinitialization and data transfer. The following describes the format 
of the initialization or deinitialization primitives between the consumer and 
Ethernet driver. 


Consumer Originated Primitives 
DL_INFO_ REQ 
Get Ethernet protocol parameter sizes. This primitive requests the 
Ethernet driver to return the size of all relevant parameters and the current 
state of the Ethernet driver. The format of the message is one 
M_PCPROTO message block: 


struct DL_info req { 
long PRIM type; /* always DL_INFO REQ */ 
“™ }; 


Return Acknowledgment of the primitive through the DL_INFO_ACK 
primitive. 
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Error The error is indicated through the DL ERROR ACK 
primitive. The valid error follows: 


DLSYSERR U 5000 System error 


DL BIND REQ 


Bind protocol address request. This primitive requests that the Ethernet 
driver bind a service access point to the Stream and return the link layer 
address associated with the Stream. The format of the message is one 
M_PROTO message block. 


struct DL_bind_req { 
long PRIM type; /* always DL_BIND REQ */ 
long LLC sap; /* the LSAP selector */ 


long GROWTH field[2]; /* 802.2 llc type 2 */ 
ii 


Return: Acknowledgment of the primitive through the DL_BIND ACK 
primitive. 

Error: These errors are indicated through the DL ERROR_ACK 
primitive. Valid errors follow: 


DLBADSAP bad LSAP selector 
DLACCES improper permissions 
DLOUTSTATE Link layer interface 
out of state 
DLSYSERR U 5000 system error 


DL_UNBIND_REQO 


Page 2 


Unbind protocol address request. This primitive requests that the Ethernet 
driver unbind the protocol address associated with the Stream and 
deactivate the Stream. The format of the message is one M PROTO 
message block. 


struct DL_unbind_req { 
long _— PRIM_type; /* always DL_UNBIND REQ */ 
}; 


Return: Acknowledgment of the primitive through the DL_ OK ACK 
primitive. 

Error: These errors are indicated through the DL ERROR ACK 
primitive. The allowable errors are as follows: 
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DLOUTSTATE Link layer interface 
o™ out of state 
i DLSYSERR U 5000 System error 


Ethernet Driver Originated Primitives 
DL_INFO_ACK 
Protocol information acknowledgment. This primitive indicates to the 
consumer any relevant Ethernet driver dependent information. The format 
of this message is one M_PROTO message block: 


struct DL_info_ack { 


long PRIM type; /* always DL_INFO_ACK */ 
long SDU_max; /* max Isdu size */ 
long SDU_min; /* min Isdu size */ 


long ADDR_length; /* LSAP address length */ 
/* in bytes */ 
long SUBNET type; /* subnet type */ 


long SERV_class; /* service class */ 
on™ long CURRENT state; /* link layer state */ 
long GROWTH field[2]; /* 802.2 LLC2 fields oF 


}; 
| The low order 16 bits of CURRENT state contain the driver state as 


described below (DL_UNBND, DL_IDLE). The high order 16 bits contain 
interface flags, which are defined in net/if-h. 


DL_BIND_ACK 
Protocol bind acknowledgment. This primitive indicates to the consumer 
that the special link layer address has been bound to the Stream and that 
the Stream associated with the specified link layer address has been 
activated. The format of the message is one M_PROTO message block: 


struct DL_bind_ack { 

long PRIM type; /* always DL_BIND_ ACK */ 

long LLC_sap; /* 1sap selector */ 

long ADDR_ length; /* LSAP address length */ 

/* in bytes */ 

i" long = ADDR_offset; /* LSAP address offset */ 
| | /* in the message */ 

long GROWTH field[2];/* 802.2 LLC2 fields */ 
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DL_ERROR_ ACK 
Error acknowledgment. This primitive indicates to the consumer that an 
error has occurred in the last consumer originated primitive. It indicates to 
the consumer that no action was taken on the primitive that caused the 
error. The format of the message is one M PCPROTO message block: 


struct DL_error_ack { 


xlong PRIM type; /* always DL_ERROR_ ACK */ 
long ERROR_prim; /* primitive in error */ 
long LLC_error; /* LLC error code */ 
long UNIX error; /* System V error code */ 
bs 
DL_OK ACK 


Success acknowledgment. This primitive indicates to the consumer that the 
previous consumer originated primitive was received successfully by the 
Ethernet driver. The format of the message is one M_PCPROTO message 


block: 
struct DL_ok_ack { 
long PRIM type; /* always DL_OK_ACK */ 


long CORRECT prim; /* correct primitive */ 
}3 
Data Transfer Primitive Formats 


The following describes the format of the data transfer primitives between the 
consumer and Ethernet driver. 


Consumer Originated Primitives 


DL_UNITDATA_REQ 
Unitdata send request. This primitive requests that the Ethernet driver 
send the specified datagram to the specified destination. The format of this 
message is one M_PROTO message block followed by one or more 
M_DATA message blocks: 


struct DL_unitdata_req { 


long PRIM type; /* always DL_UNITDATA_REQ */ 
long RA_length; /* dest LSAP addr length */ 
long RA offset; /* dest LSAP addr offset */ 
long SERV_class; /* service class */ 


long FILLER field; /* 802.2 LLC2 field */ 
}; 
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Ethernet Driver Originated Primitives 
DL _UNITDATA_IND 


Unitdata receive indication. This primitive indicates to the consumer that a 
datagram has been received from the specified remote address. The format 


of this message is one M_ PROTO Stream message block followed by one 


or more M_ DATA blocks: 


struct DL_unitdata_ind { 


long 
long 


long 
long 
long 


long 
}; 


PRIM type; 
RA_length; 


RA_ offset; 
LA_length; 
LA offset; 


SERV_class; 


DL_UDERROR_IND 
Unitdata error indication. This indicates to the consumer that a datagram 
with the specified remote address produced an error. The format of this 
message is one M PROTO message block: 


struct DL_uderror_ind { 


long 
long 


long 
long 


long 
}i 


PRIM_type; 
RA_length; 


RA_offset; 


SERV_class; 
ERROR_type; 


/* always DL_UNITDATA_IND */ 
/* dest LSAP address */ 

/* length in bytes */ 

/* dest offset LSAP into */ 
/* message */ 

/* src LSAP address length */ 
/* in bytes */ 

/* src offset LSAP into */ 

/* message */ 

/* service class */ 


/* always DL_UDERROR_IND */ 

/* dest LSAP address length */ 
/* in bytes */ 

/* dest LSAP offset into msg */ 
/* in bytes */ 

/* service class */ 

/* error type */ 


The definitions of consumer primitives are as follows: 


DL_INFO REQ 
DL_BIND REQ 


DL_UNBIND REQ 
DL_UNITDATA REQ 
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/* data link layer protocol parameter */ 


/* sizes */ 


/* bind protocol address request */ 
/* unbind protocol address request */ 
/* unit_data send request */ 
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The definitions of Ethernet primitives are as follows: 


DL_INFO_ACK 3 /* protocol information acknowledgment */ 
DL_BIND_ACK 4 /* protocol bind acknowledgment */ 
DL_ERROR_ACK 5  /* error acknowledgment */ 

DL_OK_ACK 6 /* success acknowledgment */ 
DL_UNITDATA_IND 8 /* unitdata receive indication */ 
DL_UDERROR_IND 9 /* unitdata receive indication */ 


The primitive non-fatal error return codes are described as follows: 


DLBADSAP 0  /* bad LSAP selector */ 

DLACCES 2  /* improper permissions */ 

DLOUTSTATE 3 /* Link layer interface out of state */ 
DLSYSERR 4 /* U 5000 System error */ 


Subnetwork types are: 


DL_CSMACD 0 /* CSMA/CD network (802.3) */ 
DL_TPB 1  /* Token Passing Bus (802.4) */ 
DL_TPR 2  /* Token Ring Bus (802.5) */ 
DL_METRO 3 /* Metro Net (802.6) */ 
DL_ETHER 4  /* ETHERNET bus */ 


There are two kinds of service classes for the data link layer. The Ethernet 
driver is a no-service class. 


DL_NOSERV 0 /* No service class */ 
DL_CLASSES 1 /* Has a service class */ 


The current state of the Ethernet driver is defined as follows: 


DL_UNBND 0 /* LL not bound */ 

DL_WACK_B 1 /* LL waiting for bind ack */ 

DL_WACK_U 2  /* LL waiting for unbind ack */ 

DL_IDLE 3 fh is'active */ 

Ioctls 
Five ioctls are supported by the Ethernet driver. When these ioctls are issued by 
the user level, an M_IOCTL message and the relevant parameters are generated 
by the Stream head and sent downstream. 


The format of these ioctls is as follows: 
ioctl (net, I STR, &ioc) 
I_ STR contructs a M_IOCTL message from the data pointed to by &ioc and 
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sends that message downstream. For this request, the ioctl blocks until the 
system responds with either an M_IOCACK (positive acknowledgment) or 
M_IOCNACK (negative acknowledgment). 


To send these ioctls, ioc must point to a structure of the following form: 


struct strioct] { 


int ic_cmd; /* command */ 

int ic_timout; /* timeout value */ 
int ic_len; /* length of data */ 
char ay (cae oy /* pointer to data */ 


}; 
For selecting the hardware for the Ethernet interface, each parameter in the 
structure of strioctl may be set as follows : 
ioc.ic cmd = IF_UNITSEL; 
ioc.ic_timout = 0; 
ioc.ic_ len = sizeof(int); 
ioc.ic dp = (char *) &unit; 
where unit is the selected unit number, 0 to select the Ethernet board. 


For getting the Ethernet address from the hardware, each parameter in the 
structure of strioctl may be set as follows : 


ioc.ic cmd = SIOCGENADDR; 
ioc.ic_timout = 0; 
ioc.ic_ len = 0; 
ioc.ic_dp = buf; 
where buf is an array of NADDRLEN(6) bytes. When the ioctl returns, buf has 
been filled with the Ethernet address. 
For reading Ethernet statistics, the strioctl fields are set as follows: 
ioc.ic cmd = SIOCGENPSTATS; 
ioc.ic_fimout = 0; 
ioc.ic_ len = 0; 
ioc.ic dp = &enpstat; 
where enpstat is a struct enpstats, defined in if_enp.h. 
For getting the interface flags, set: 


ioc.ic cmd = SIOCGIFFLAGS; 
ioc.ic_timout = 0; 
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ioc.ic_ len = sizeof(struct ifreq); 
ioc.ic dp = &ifreq; 


For getting the interface flags, set: 


ioc.ic_ cmd = SIOCSIFFLAGS; 
ioc.ic_timout = 0; 

ioc.ic_ len = sizeof(struct ifreq); 
ioc.ic dp = &ifreq; 


where ifreq is a structure defined in net/if.h. The flags are returned in 
ifreq.ifr_flags. 


FILES 
/dev/net 
/dev/net2 
/usr/include/sys/tihdr.h 
/usr/include/sys/stropts.h 
/usr/include/sys/stream.h 
/usr/include/sys/socket.h 
/usr/include/net/if.h 
/usr/include/netinet/if_enp.h 
/usr/include/netinet/if_ether.h 
/usr/include/sys/comm.h 


SEE ALSO 
streamio(7) 
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NAME 
~~ null - the null file 


DESCRIPTION 
Data written on the null special file, /dev/null, is discarded. 


Reads from a null special file always return 0 bytes. 


FILES 
/dev/null 
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NAME 
prf - operating system profiler 


DESCRIPTION 
The special file /dev/prf provides access to activity information in the operating 
system. Writing the file loads the measurement facility with text addresses to be 
monitored. Reading the file returns these addresses and a set of counters 
indicative of activity between adjacent text addresses. 


The recording mechanism is driven by the system clock and samples the program 
counter at line frequency. Samples that catch the operating system are matched 

against the stored text addresses and increment corresponding counters for later 

processing. 


The file /dev/prf is a pseudo-device with no associated hardware. 


FILES 
/dev/prf 


SEE ALSO 
profiler(1M) 
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NAME 
pty - pseudo terminal driver 


DESCRIPTION 
A pseudo terminal provides a terminal-like communication channel between two 
processes. Each pseudo terminal consists of two devices: a slave device, whose 
name is of the form /dev/ttypxx, where xx is the pseudo terminal number; and a 
master device, whose name is of the form /dev/vtxx, where xx is the pseudo 
terminal number. 


The slave device responds to system calls just like a real terminal. See tennio(7). 
Thus it can control interactive programs such as vi, but the slave device does not 
actually perform I/O; reads and writes on the slave device are written and read 
on the corresponding master device by another process. A typical use of a 
pseudo terminal is to put a network server on the master device and login 
program on the slave. 


See config(1M) for more details about configuring pseudo terminals. 


FILES 
/dev/ttyp?? — slave devices 


/dev/vt?? master devices 
/kernel/unisys/conf/modules/ptc 
/kernel/unisys/conf/modules/pts 


SEE ALSO 


config(1M), termio(7) 
ttyname(3C) in the Programmer’s Reference Manual 
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NAME 
cf” sd - driver for the SCSI disks 


DESCRIPTION 
The hardware configuration of the Small Computer System Interface (SCSI) 
consists of one SCSI Host Controller and as many as four disk controllers and 
three tape controllers and/or one SCSI Mass Storage Controller and as many as 
two internal SCSI disk devices, two internal SCSI streaming tape devices, and one 
flexible disk device. Each disk controller controls as many as four disk drives. 


The High Performance Mass Storage Controller (HPMSC) provides the same 
functionality and configurability as having both the SCSI Host Controller and the 
SCSI Mass Storage Controller in the system. Note that a system may contain 
either the HPMSC or the SCSI Host Controller and/or the SCSI Mass Storage 
Controller. 


The disks are formatted according to the type of disk as determined by 
format(1M). The format information is then read from block 0 of the disk by the 
driver during start-of-day processing to configure the controller/driver. 


Information regarding vector number, Multibus I/O address, and strapping on the 
controller can be obtained by running show(1M). 


SCSI Disk Partitions 
SCSI disks can be partitioned. Partitioning allows the user to divide one physical 
disk into several logical disks. To the driver, a partition appears to be a discrete 
physical device. All I/O requests are range checked to insure that they reside 
entirely within the partition specified by the minor number. 


Partitions are defined by dkpart(1M). The driver reads the partition table from 
the disk(s) during start-of-day processing. The partition being referenced is 
determined by bits 2-5 of the minor number. The maximum number of partitions 
allowed per unit is sixteen. 


Minor Numbers 
The minor number specifies the SCSI logical unit number (Bits 0-1), the disk 
partition number (Bits 2-5), and the SCSI device identification (Bits 6-7). 


O) res 


/dev/dsk/[6-21]s{0-f] 
/dev/rdsk/{[6-21]s[0-f] 


SEE ALSO 
format(1M), verify(1M), dkpart(1M), newfs(1M), ss(7) 
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NAME 
sp - STREAMS pipe device 


DESCRIPTION 
The sp driver provides a machine-local interprocess communication mechanism 
using streams. The communication mechanism works by cross-connecting the 
"bottom" of two streams, so that writes to one stream can be read on the other. 
To facilitate selection of an unused streams pipe device, the sp device driver 
automatically allocates the next available master when invoked from the 
STREAMS clone device driver by opening /dev/spx. See clone(7). An open file 
descriptor with read and write access to a streams pipe device is returned. 


To use a streams pipe, the application must first open two streams pipe devices 
(either by explicit name or by clone open). Call the file descriptors returned 
from the opens fd0 and fdl. Next, the application must "connect" the two 
streams pipes (fd0 and fd1) using a ] FDINSERT ioctl. See streamio(7). 


Once two streams pipes are connected, a write on one "end" of the pipe can be 
read on the other end. A write of data onto fd0 can be read on fdJ, and vice- 
versa. This communication scheme differs from regular pipes in that it is "full 
duplex". 


Streams pipes provides machine local, bidirectional communication with all the 
basic interfaces available to streams: the application can pollQ on streams file 
descriptors, and it can use either byte oriented transfers (read(), write() ) or 
record oriented transfers (getmsg()/putmsg()). 


Streams pipes has another facility, called "file descriptor passing". The 
mechanism uses I SENDFD, and I RECVFD ioctl()s to pass an open file 
descriptor from one process to another through a streams pipe. (See 
streamio(7). With this mechanism, it is possible for unrelated processes to have 
pointers to the same file table entry. This can be used to create a client/server 
communication structure. The facility works like this: 


fd0 and fdl are streams pipes which are opened and connected by the parent 
process of a pool of servers. The parent then does a mknod() system call to 
create a character special file on disk with the major/minor numbers of fdJ, and 
giving it a name, for example server head. Server_head is now a globally accessible 
name for the fd/ end of the streams pipe of the server. Every member of the 
server pool then does ioctl(fd0, 1 RECVFD, &fdstructure). Each server blocks 
until it receives a file descriptor. This file descriptor is from a client wanting to 
communicate with a server. This file descriptor may be for one end of another 
streams pipe pair, or it may be for an ordinary pipe or even a disk file. The 
server can then converse with the client through the passed file descriptor. When 
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the conversation is finished, the server can close the passed fd and wait again at 
the ioctlQ. 


Oo 


The client wanting to talk with a server first creates its own connected streams 
pipe pair, e.g. getting back fda and fdb. Then, it opens the special file server head 
(see above) created by the first server, receiving a file descriptor fdc. The client 
can then perform the system call ioctl(fdc, 1 SENDFD, fda) to send the file 
descriptor for one of the pipe ends for his streams pipe to a server. The server 
and client can then communicate over the streams pipe created by the client, 
using file descriptors fda and fab. 


FILES 
/dev/spx 
/kernel/unisys/conf/modules/sp/config 


SEE ALSO 
clone(7), streamio(7) 
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NAME 
ss - driver for the SCSI tapes 


DESCRIPTION | 
The hardware configuration of the Small Computer System Interface (SCSI) 
consists of one SCSI Host Controller and as many as four disk controllers and 
three tape controllers and/or one SCSI Mass Storage Controller and as many as 
two internal SCSI disk devices, two internal SCSI streaming tape devices, and one 
flexible disk device. Each tape controller controls one tape drive. 


The High Performance Mass Storage Controller (HPMSC) provides the same 
functionality and configurability as having both the SCSI Host Controller and the 
SCSI Mass Storage Controller in the system. Note that a system may contain 
either the HPMSC or the SCSI Host Controller and/or the SCSI Mass Storage 
Controller. 


Information regarding vector number, Multibus I/O address, and strapping on the 
controller can be obtained by running show(1M). 


MINOR NUMBER 
Unit number, rewind option, and controller identification are encoded in the 
minor number. The minor number is an 8 bit field as follows: 


Bit(s) Description 
0-1 Unit number 0-3 
2-3 00 - rewind on open and close 
01 - rewind on open; no rewind on close 
10 - no rewind on open; rewind on close 
11 - no rewind on open and close 


4 Recording density; 0 - 1600 bpi, 1 - 3200 bpi 
5-7 SCSI device identification 
FILES 
/dev/rmt/* 
SEE ALSO 
sd(7) 
RESTRICTIONS 


The SCSI tape controller restricts transfer block size lengths to 64 kilobytes or 
less. If the user buffer is 2 kilobyte-aligned (i.e., begins on 2 kilobyte page 
boundaries), then the transfer size may be up through 64 kilobyte; otherwise, the 
transfer size may not exceed [64 kilobyte - (buffer address modulo 2048)]. 
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NAME 


streamio - STREAMS ioctl commands 


SYNOPSIS 


#include <stropts.h> 
int ioctl (fildes, command, arg) 
int fildes, command; 


DESCRIPTION 


STREAMS [see intro(2)] ioctl commands are a subset of ioctl(2) system calls 
which perform a variety of control functions on Streams. The arguments 
command and arg are passed to the file designated by fildes and are interpreted 
by the Stream head. Certain combinations of these arguments may be passed to 
a module or driver in the Stream. 


fildes is an open file descriptor that refers to a Stream. command determines the 
control function to be performed as described below. arg represents additional 
information that is needed by this command. The type of arg depends upon the 
command, but it is generally an integer or a pointer to a command-specific data 
structure. 


Since these STREAMS commands are a subset of ioctl, they are subject to the 
errors described there. In addition to those errors, the call fails with ermo set to 
EINVAL, without processing a control function, if the Stream referenced by 
fildes is linked below a multiplexor, or if command is not a valid value for a 
Stream. 


Also, as described in ioctl, STREAMS modules and drivers can detect errors. In 
this case, the module or driver sends an error message to the Stream head 
containing an error value. This causes subsequent system calls to fail with ermo 
set to this value. 


COMMAND FUNCTIONS 


The following ioctl commands, with error values indicated, are applicable to all 
STREAMS files: 


I PUSH Pushes the module whose name is pointed to by arg onto the top 
of the current Stream, just below the Stream head. It then calls 
the open routine of the newly-pushed module. On failure, ermo is 
set to one of the following values: 


[EINVAL] Invalid module name. 
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I POP 


I LOOK 


I FLUSH 


I SETSIG 
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[EFAULT] arg points outside the allocated address space. 
[ENXIO] Open routine of new module failed. a 
[ENXIO] Hangup received on fildes. 


Removes the module just below the Stream head of the Stream 
pointed to by fildes. arg should be 0 in an I_ POP request. On 
failure, ermo is set to one of the following values: 


[EINVAL] No module present in the Stream. 
[ENXIO] Hangup received on fildes. 


Retrieves the name of the module just below the Stream head of 
the Stream pointed to by fildes, and places it in a null terminated 
character string pointed at by avg. The buffer pointed to by arg 
should be at least FMNAMESZ + 1 bytes long. An "#include 

< sys/conf.h>" declaration is required. On failure, ermo is set to 
one of the following values: 


[EFAULT] arg points outside the allocated address space. : 
[EINVAL] No module present in Stream. WO 


This request flushes all input and/or output queues, depending on 
the value of arg. Legal arg values are: 


FLUSHR Flush read queues. 

FLUSHW Flush write queues. 

FLUSHRW _ Flush read and write queues. 

On failure, ermo is set to one of the following values: 
[EAGAIN] Unable to allocate buffers for flush message. 
[EINVAL] Invalid arg value. 

[ENXIO] Hangup received on fildes. 


Informs the Stream head that the user wishes the kernel to issue 

the SIGPOLL signal [see signal(2) and sigset(2)] when a particular * 
event has occurred on the Stream associated with fildes. | WS 
I_ SETSIG supports an asynchronous processing capability in 

STREAMS. The value of arg is a bitmask that specifies the 

events for which the user should be signaled. It is the bitwise-OR 

of any combination of the following constants: 
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S INPUT 


S HIPRI 


S OUTPUT 


S MSG 
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A non-priority message has arrived on a Stream 
head read queue, and no other messages existed 
on that queue before this message was placed 
there. This is set even if the message is of zero 


length. 


A priority message is present on the Stream head 
read queue. This is set even if the message is of 
zero length. 


The write queue just below the Stream head is no 
longer full. This notifies the user that there is 
room on the queue for sending (or writing) data 
downstream. 


A STREAMS signal message that contains the 
SIGPOLL signal has reached the front of the 
Stream head read queue. 


A user process may choose to be signaled only of priority 
messages by setting the avg bitmask to the value S HIPRI. 


Processes that wish to receive SIGPOLL signals must explicitly 
register to receive them using I SETSIG. If several processes 
register to receive this signal for the same event on the same 
Stream, each process is signaled when the event occurs. 


If the value of arg is zero, the calling process is unregistered and 
does not receive further SIGPOLL signals. On failure, ermo is 
set to one of the following values: 


[EINVAL] 


[EAGAIN] 


arg value is invalid or arg is zero and process is not 
registered to receive the SIGPOLL signal. 


Allocation of a data structure to store the signal 
request failed. 


Returns the events for which the calling process is currently 
registered to be sent a SIGPOLL signal. The events are returned 
as a bitmask pointed to by avg, where the events are those 
specified in the description of I SETSIG above. On failure, ermo 
is set to one of the following values: 


[EINVAL] 


Process not registered to receive the SIGPOLL 
signal. 
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I FIND 


| PEEK 


I SRDOPT 
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[EFAULT] arg points outside the allocated address space. 


This request compares the names of all modules currently present 
in the Stream to the name pointed to by arg, and returns 1 if the 
named module is present in the Stream. It returns 0 if the named 
module is not present. On failure, ermo is set to one of the 
following values: 


[EFAULT] arg points outside the allocated address space. 
[EINVAL] arg does not contain a valid module name. 


This request allows a user to retrieve the information in the first 
message on the Stream head read queue without taking the 
message off the queue. arg points to a strpeek structure which 
contains the following members: 


struct strbuf ctlbuf; 
struct strbuf databuf; 
long flags; 


The maxien field in the ctlbuf and databuf strbuf structures [see 
getmsg(2)] must be set to the number of bytes of control 
information and/or data information, respectively, to retrieve. If 
the user sets flags to RS_HIPRI, I_ PEEK only looks for a priority 
message on the Stream head read queue. 


]_ PEEK returns 1 if a message was retrieved, and returns 0 if no 
message was found on the Stream head read queue, or if the 
RS_HIPRI flag was set in flags and a priority message was not 
present on the Stream head read queue. It does not wait for a 
message to arrive. On return, ctlbuf specifies information in the 
control buffer, databuf specifies information in the data buffer, 
and flags contains the value 0 or RS_HIPRI. On failure, ermo is 
set to the following value: 


[EFAULT] arg points, or the buffer area specified in ctlbuf or 
databuf is, outside the allocated address space. 


Sets the read mode using the value of the argument arg. Legal arg 
values are: 


RNORM _Byte-stream mode, the default. 
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I GRDOPT 


I NREAD 


I FDINSERT 
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RMSGD _ Message-discard mode. 
RMSGN __ Message-nondiscard mode. 


Read modes are described in read(2). On failure, ermo is set to 
the following value: 


[EINVAL] arg is not one of the above legal values. 


Returns the current read mode setting in an int pointed to by the 
argument arg. Read modes are described in read(2). On failure, 
ermo is set to the following value: 


[EFAULT] arg points outside the allocated address space. 


Counts the number of data bytes in data blocks in the first 
message on the Stream head read queue, and places this value in 
the location pointed to by arg. The return value for the command 
is the number of messages on the Stream head read queue. For 
example, if zero is returned in arg, but the ioct/ return value is 
greater than zero, this indicates that a zero-length message is next 
on the queue. On failure, evmo is set to the following value: 


[EFAULT] arg points outside the allocated address space. 


creates a message from user specified buffer(s), adds information 
about another Stream and sends the message downstream. The 
message contains a control part and an optional data part. The 
data and control parts to be sent are distinguished by placement 
in separate buffers, as described below. 


arg points to a strfdinsert structure which contains the following 
members: 


struct strbuf ctlbuf; 
struct strbuf databuf; 


long flags; 
int fd; 
int offset; 


The /en field in the ctlbuf strbuf structure [see putmsg(2)| must be 
set to the size of a pointer plus the number of bytes of control 
information to be sent with the message. fd specifies the file 
descriptor of the other Stream and offset, which must be word- 
aligned, specifies the number of bytes beyond the beginning of the 
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control buffer where I FDINSERT stores a pointer to the fd 
Stream’s driver read queue structure. The /en field in the databuf 
strbuf structure must be set to the number of bytes of data 
information to be sent with the message or zero if no data part is 


to be sent. 


flags specifies the type of message to be created. A non-priority 
message is created if flags is set to 0, and a priority message is 
created if flags is set to RS _HIPRI. For non-priority messages, 

I FDINSERT blocks if the Stream write queue is full due to 
internal flow control conditions. For priority messages, 

I FDINSERT does not block on this condition. For non-priority 
messages, | FDINSERT does not block when the write queue is 
full and O NDELAY is set. Instead, it fails and sets ermo to 


EAGAIN. 


I FDINSERT also blocks, unless prevented by lack of internal 
resources, waiting for the availability of message blocks in the 
Stream, regardless of priority or whether O NDELAY has been 
specified. No partial message is sent. On failure, emo is set to 
one of the following values: 


[EAGAIN] 


[EAGAIN] 
[EFAULT] 


[EINVAL] 


[ENXIO] 
[ERANGE] 


A non-priority message was specified, the 
O_NDELAY flag is set, and the Stream write 
queue is full due to internal flow control 
conditions. 


Buffers could not be allocated for the message 
that was to be created. 


arg points, or the buffer area specified in ctlbuf or 
databuf is, outside the allocated address space. 


One of the following: fd in the strfdinsert structure 
is not a valid, open Stream file descriptor; the size 
of a pointer plus offset is greater than the /en field 
for the buffer specified through ctlptr; offset does 
not specify a properly-aligned location in the data 
buffer; an undefined value is stored in flags. 


Hangup received on fildes. 


The /en field for the buffer specified through 
databuf does not fall within the range specified by 
the maximum and minimum packet sizes of the 


UP-14805 


STREAMIO(7) 


1 STR 


UP-14805 


topmost Stream module, or the /en field for the 
buffer specified through databuf is larger than the 
maximum configured size of the data part of a 
message, or the /en field for the buffer specified 
through ctlbuf is larger than the maximum 
configured size of the control part of a message. 


Constructs an internal STREAMS ioctl message from the data 
pointed to by arg, and sends that message downstream. 


This mechanism is provided to send user ioctl requests to 
downstream modules and drivers. It allows information to be sent 
with the ioctl, and returns to the user any information sent 
upstream by the downstream recipient. I_STR blocks until the 
system responds with either a positive or negative 
acknowledgment message, or until the request "times out" after 
some period of time. If the request times out, it fails with ermo 
set to ETIME. 


At most, one I_ STR can be active on a Stream. Further I STR 
calls block until the active I STR completes at the Stream head. 
The default timeout interval for these requests is 15 seconds. The 
O NDELAY [see open(2)] flag has no effect on this call. 


To send requests downstream, arg must point to a strioctl 
structure which contains the following members: 


int  ic_cmd; /* downstream command */ 
int ic_timout; /* ACK/NAK timeout */ 
int ic len; /* length of data arg */ 
char ‘*ic dp; . /* ptr to data arg */ 


ic_cmd is the internal ioctl command intended for a downstream ~ 
module or driver and ic_timout is the number of seconds (-1 = 
infinite, 0 = use default, >0 = as specified) an I_ STR request 
waits for acknowledgment before timing out. ic_/en is the number 
of bytes in the data argument and ic_dp is a pointer to the data 
argument. The ic_/en field has two uses: on input, it contains the 
length of the data argument passed in, and on return from the 
command, it contains the number of bytes being returned to the 
user (the buffer pointed to by ic_dp should be large enough to 
contain the maximum amount of data that any module or the 
driver in the Stream can return). | 
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The Stream head converts the information pointed to by the 
strioctl structure to an internal ioctl command message and sends 
it downstream. On failure, ermo is set to one of the following 
values: 


[EAGAIN] 
Unable to allocate buffers for the ioctl message. 


[EFAULT] 
arg points, or the buffer area specified by ic_dp and ic len 
(separately for data sent and data returned), is outside the 
allocated address space. 


[EINVAL] 
ic_len is less than 0 or ic len is larger than the maxmum 
configured size of the data part of a message or ic_fimout is 
less than -1. 


[ENXIO] 
Hangup received on fildes. 


[ETIME] 
A downstream ioctl timed out before acknowledgment was 
received. 


An I_STR can also fail while waiting for an acknowledgment if a 
message indicating an error or a hangup is received at the Stream 
head. In addition, an error code can be returned in the positive 
or negative acknowledgment message, in the event the ioctl 
command sent downstream fails. For these cases, I STR fails 
with evmo set to the value in the message. 


Requests the Stream associated with fildes to send a message, 
containing a file pointer, to the Stream head at the other end of a 
2Stream pipe. The file pointer corresponds to arg, which must be 
an integer file descriptor. 


I SENDFD converts arg into the corresponding system file 
pointer. It allocates a message block and inserts the file pointer 
in the block. The user ID and group ID associated with the 
sending process are also inserted. This message is placed directly 
on the read queue [sce intro(2)] of the Stream head at the other 
end of the Stream pipe to which it is connected. On failure, ermo 
is set to one of the following values: 
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[EAGAIN] _ The sending Stream is unable to allocate a 
message block to contain the file pointer. 


[EAGAIN] _ The read queue of the receiving Stream head is 
full and cannot accept the message sent by 
J SENDFD. 


[EBADF] arg is not a valid, open file descriptor. 
[EINVAL] _fildes is not connected to a Stream pipe. 
[ENXIO] Hangup received on fildes. 


I RECVFD Retrieves the file descriptor associated with the message sent by 
an I SENDFD ioctl over a Stream pipe. avg is a pointer to a data 
buffer large enough to hold an strrecvfd data structure containing 
the following members: 


int fd; 

unsigned short uid; 
unsigned short gid; 
char fill[8]; 


fd is an integer file descriptor. uid and gid are the user ID and 
group ID, respectively, of the sending Stream. 


If O NDELAY is not set [see open(2)], I RECVFD blocks until 
a message is present at the Stream head. If O NDELAY is set, 
I RECVFD fails with ermo set to EAGAIN if no message is 
present at the Stream head. 


If the message at the Stream head is a message sent by an 

I SENDFD, a new user file descriptor is allocated for the file 
pointer contained in the message. The new file descriptor is 
placed in the fd field of the strrecvfd structure. The structure is 
copied into the user data buffer pointed to by avg. On failure, 
ermo is set to one of the following values: 


[EAGAIN] _ A message was not present at the Stream head 
read queue, and the O NDELAY flag is set. 


[EBADMSG] The message at the Stream head read queue was 
not a message containing a passed file descriptor. 


[EFAULT] arg points outside the allocated address space. 
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[EMFILE] NOFILES file descriptors are currently open. 
[ENXIO] Hangup received on fildes. 


The following two commands are used for connecting and disconnecting 
multiplexed STREAMS configurations. 


I LINK 


I UNLINK 
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Connects two STREAMS, where fildes is the file descriptor of the 
Stream connected to the multiplexing driver, and arg is the file 
descriptor of the Stream connected to another driver. The 
Stream designated by avg gets connected below the multiplexing 
driver. I LINK requires the multiplexing driver to send an 
acknowledgment message to the Stream head regarding the 
linking operation. This call returns a multiplexor ID number (an 
identifier used to disconnect the multiplexor, see I UNLINK) on 
success, and a -1 on failure. On failure, ermo is set to one of the 
following values: 


[ENXIO] Hangup received on fildes. 


[ETIME] Time out before acknowledgment message was 
received at Stream head. 


[EAGAIN] — Unable to allocate STREAMS storage to perform 
the I LINK. 


[EBADF] arg is not a valid, open file descriptor. 
[EINVAL] _fildes Stream does not support multiplexing. 


[EINVAL] arg is not a Stream, or is already linked under a 
multiplexor. 


[EINVAL] _ The specified link operation would cause a "cycle" 
in the resulting configuration; that is, if a given 
Stream head is linked into a multiplexing 
configuration in more than one place. 


An I_LINK can also fail while waiting for the multiplexing driver 
to acknowledge the link request, if a message indicating an error 
or a hangup is received at the Stream head of fildes. In addition, 
an error code can be returned in the positive or negative 
acknowledgment message. For these cases, I_ LINK fails with 
ermo set to the value in the message. 


Disconnects the two Streams specified by fildes and arg. fildes is 
the file descriptor of the Stream connected to the multiplexing 
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driver. arg is the multiplexor ID number that was returned by the 
ioctl 1 LINK command when a Stream was linked below the 
multiplexing driver. If arg is -1, then all Streams which were 
linked to fildes are disconnected. As in I_LINK, this command 
requires the multiplexing driver to acknowledge the unlink. On 
failure, ermo is set to one of the following values: 


[ENXIO] Hangup received on fildes. 


[ETIME] Time out before acknowledgment message was 
received at Stream head. 


[EAGAIN] Unable to allocate buffers for the acknowledgment 
message. 


[EINVAL] Invalid multiplexor ID number. 


An I_UNLINK can also fail while waiting for the multiplexing 
driver to acknowledge the link request, if a message indicating an 
error or a hangup is received at the Stream head of fildes. In 
addition, an error code can be returned in the positive or 
negative acknowledgment message. For these cases, 1 UNLINK 
fails with ermo set to the value in the message. 


SEE ALSO 
close(2), fentl(2), intro(2), 1octl(2), open(2), read(2), getmsg(2), poll(2), 
putmsg(2), signal(2), sigset(2), write(2) in the Programmer’s Reference Manual 
STREAMS Programmer’s Guide 
STREAMS Primer 


DIAGNOSTICS 
Unless previously specified otherwise, the return value from ioctl is 0 upon 
success and -1 upon failure with ermo set as indicated. 
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NAME 


sxt - pseudo-device driver 


DESCRIPTION 


The special file /dev/sxt is a pseudo-device driver that interposes a discipline 
between the standard tty line disciplines and a real device driver. The standard 
disciplines manipulate virtual tty structures (channels) declared by the /dev/sxt 
driver. /dev/sxt acts as a discipline manipulating a real tty structure declared by a 
real device driver. The /dev/sxt driver is currently only used by the sh/(1) 
command. 


Virtual ttys are named by inodes in the subdirectory /dev/sxt and are allocated in 
groups of up to eight. To allocate a group, a program should exclusively open a 
file with a name of the form /dev/sxt/??0 (channel 0) and then execute a 
SXTIOCLINK ioctl call to initiate the multiplexing. 


Only one channel, the controlling channel, can receive input from the keyboard at 
a time; others attempting to read are blocked. 


There are two groups of ioctl(2) commands supported by sxt. The first group 
contains the standard ioct] commands described in termio(7), with the addition of 
the following: 


TIOCEXCL Set exclusive use mode: no further opens are permitted 
until the file has been closed. 

TIOCNXCL Reset exclusive use mode: further opens are once again 
permitted. 


The second group are commands to sxt itself. Some of these may only be 
executed on channel 0. 


SXTIOCLINK Allocate a channel group and multiplex the virtual ttys 
onto the real tty. The argument is the number of 
channels to allocate. This command may only be 
executed on channel 0. Possible errors include: 


EINVAL The argument is out of range. 
ENOTTY The command was not issued from a real tty. 
ENXIO __ linesw is not configured with sxt. 


EBUSY An SXTIOCLINK command has already 
been issued for this real tty. 
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SXTIOCSWTCH 


SXTIOCWF 


SXTIOCUBLK 


SXTIOCSTAT 


SXTIOCTRACE 


SXTIOCNOTRACE 


FILES 
/dev/sxt/?? [0-7] 


SEE ALSO 
termio(7) 


ENOMEM 
There is no system memory available for 
allocating the virtual tty structures. 


EBADF Channel 0 was not opened before this call. 
Set the controlling channel. Possible errors include: 
EINVAL An invalid channel number was given. 


EPERM The command was not executed from 
channel 0. 


Cause a channel to wait until it is the controlling channel. 
This command returns the error, EINVAL, if an invalid 
channel number is given. 


Turn off the loblk control flag in the virtual tty of the 
indicated channel. The error EJNVAL is returned if an 
invalid number or channel 0 is given. 


Get the status (blocked on input or output) of each 
channel and store in the sxtblock structure referenced by 
the argument. The error EFAULT is returned if the 
structure cannot be written. 


Enable tracing. Tracing information is written to the 
console. This command has no effect if tracing is not 
configured. 


Disable tracing. This command has no effect if tracing is 
not configured. 


Virtual tty devices 


shl(1), stty(1) in the User’s Reference Manual 
1octl(2), open(2) in the Programmer’s Reference Manual 
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NAME 
termio - general terminal interface 


DESCRIPTION 
All of the asynchronous communications ports use the same general interface, no 
matter what hardware is involved. The remainder of this section discusses the 
common features of this interface. 


When a terminal file is opened, it normally causes the process to wait until a 
connection is established. In practice, users’ programs seldom open terminal 
files; they are opened by getty and become a user’s standard input, output, and 
error files. The very first terminal file opened by the process group leader of a 
terminal file not already associated with a process group becomes the control 
terminal for that process group. The control terminal plays a special role in 
handling quit and interrupt signals, as discussed below. The control terminal is 
inherited by a child process during a fork(2). A process can break this 
association by changing its process group using setpgrp(2). 


A terminal associated with one of these files ordinarily operates in full-duplex 
mode. Characters may be typed at any time, even while output is occurring, and 

| are only lost when the system’s character input buffers become completely full, 
which is rare, or when the user has accumulated the maximum allowed number of 
input characters that have not yet been read by some program. Currently, this 
limit is 256 characters. When the input limit is reached, the buffer is flushed and 
all the saved characters are thrown away without notice. 


Normally, terminal input is processed in units of lines. A line is delimited by a 
new-line (ASCII LF) character, an end-of-file (ASCII EOT) character, or an 
end-of-line character. This means that a program attempting to read ts 
suspended until an entire line has been typed. Also, no matter how many 
characters are requested in the read call, at most one line is returned. It is not, 
however, necessary to read a whole line at once; any number of characters may 
be requested in a read, even one, without losing information. 


During input, erase and kill processing is normally done. By default, the 
character # erases the last character typed, except that it does not erase beyond 
the beginning of the line. By default, the character @ kills (deletes) the entire 

‘™ input line, and optionally outputs a new-line character. Both these characters 
operate on a key-stroke basis, independently of any backspacing or tabbing that 
may have been done. Both the erase and kill characters may be entered literally 
by preceding them with the escape character (\). In this case the escape 
character is not read. The erase and kill characters may be changed. 
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Certain characters have special functions on input. These functions and their 
default character values are summarized as follows: 


INTR 


QUIT 


SWTCH 


ERASE 


KILL 


EOF 


START 
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(Rubout or ASCII DEL) generates an interrupt signal which is sent to 
all processes with the associated control terminal. Normally, each such 
process is forced to terminate, but arrangements may be made either to 
ignore the signal or to receive a trap to an agreed-upon location; see 
signal(2). 

(Control-| or ASCII FS) generates a quit signal. Its treatment is 
identical to the interrupt signal except that, unless a receiving process 


has made other arrangements, it is not only terminated but a core 
image file (called core) is created in the current working directory. 


(Control-z or ASCII SUB) is used by the job control facility, shZ, to 
change the current layer to the control layer. 


(#) erases the preceding character. It does not erase beyond the start 
of a line, as delimited by a NL, EOF, or EOL character. 


(@) deletes the entire line, as delimited by a NL, EOF, or EOL 
character. 


(Control-d or ASCII EOT) may be used to generate an end-of-file 
from a terminal. When received, all the charactérs waiting to be read 
are immediately passed to the program, without waiting for a new-line, 
and the EOF is discarded. Thus, if there are no characters waiting, 
which is to say the EOF occurred at the beginning of a line, zero 
characters are passed back, which is the standard end-of-file indication. 


(ASCII LF) is the normal line delimiter. It cannot be changed or 
escaped. 


(ASCII NUL) is an additional line delimiter, like NL. It is not 
normally used. 


is another additional line delimiter. 


(Control-s or ASCII DC3) can be used to temporarily suspend output. 
It is useful with CRT terminals to prevent output from disappearing 
before it can be read. While output is suspended, STOP characters are 
ignored and not read. 


(Control-q or ASCII DC1) is used to resume output which has been 
suspended by a STOP character. While output is not suspended, 
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START characters are ignored and not read. The start/stop characters 
cannot be changed or escaped. 


The character values for INTR, QUIT, SWTCH, ERASE, KILL, EOF, and EOL 
may be changed to suit individual tastes. The ERASE, KILL, and EOF 
characters may be escaped by a preceding \ character, in which case no special 
function is done. 


When the carrier signal from the data-set drops, a hang-up signal is sent to all 
processes that have this terminal as the control terminal. Unless other 
arrangements have been made, this signal causes the processes to terminate. If 
the hang-up signal is ignored, any subsequent read returns with an end-of-file 
indication. Thus, programs that read a terminal and test for end-of-file can 
terminate appropriately when hung up on. 


When one or more characters are written, they are transmitted to the terminal as 
soon as previously-written characters have finished typing. Input characters are 
echoed by putting them in the output queue as they arrive. If a process produces 
characters more rapidly than they can be typed, it is suspended when its output 
queue exceeds some limit. When the queue has drained down to some threshold, 
the program is resumed. 


Several ioctl(2) system calls apply to terminal files. The primary calls use the 
following structure, defined in <termio.h>: 


#define NCC 8 
struct  termio { 


unsigned short  c iflag; /* input modes */ 
unsigned short  c oflag; /* output modes */ 
unsigned short c _cflag; /* control modes */ 
unsigned short  c Iflag; /* local modes */ 
char c_line; /* line discipline */ 


unsigned char  c_cc{NCC]; /* control chars */ 
}; 
The special control characters are defined by the array c_cc. The relative 
positions and initial values for each function are as follows: 


0 VINTR DEL 
1 VQUIT FS 

2 VERASE # 

3 VKILL @ 

4 VEOF  EOT 
5 VEOL NUL 
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6 reserved 
7 SWTCH 


The c_ iflag field describes the basic terminal input control: 


IGNBRK 0000001 Ignore break condition. 

BRKINT — 0000002 Signal interrupt on break. 

IGNPAR 0000004 Ignore characters with parity errors. 
PARMRK 0000010 Mark parity errors. 

INPCK 0000020 Enable input parity check. 

ISTRIP 0000040 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore CR. 

ICRNL 0000400 Map CR to NL on input. 

IUCLC 0001000 Map uppercase to lowercase on input. 
IXON 0002000 Enable start/stop output control. 
IXANY 0004000 Enable any character to restart output. 
IXOFF 0010000 Enable start/stop input control. 


If IGNBRK is set, the break condition (a character framing error with data all 
zeros) is ignored, that is, not put on the input queue and therefore not read by 
any process. Otherwise if BRKINT is set, the break condition generates an 
interrupt signal and flushes both the input and output queues. If IGNPAR is set, 
characters with other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity error which is not 
ignored is read as the three-character sequence: 0377, 0, X, where X is the data 
of the character received in error. To avoid ambiguity in this case, if ISTRIP is 
not set, a valid character of 0377 is read as 0377, 0377. If PARMRK is not set, a 
framing or parity error which is not ignored is read as the character NUL (0). 


If INPCK is set, input parity checking is enabled. If INPCK is not set, input 
parity checking is disabled. This allows output parity generation without input 
parity errors. 


If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise all 
8-bits are processed. 


If INLCR is set, a received NL character is translated into a CR character. If 
IGNCR is set, a received CR character is ignored (not read). Otherwise if 
ICRNL is set, a received CR character is translated into a NL character. 


If IUCLC is set, a received uppercase alphabetic character is translated irito the 
corresponding lowercase character. 
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If IXON is set, start/stop output control is enabled. A received STOP character 
suspends output and a received START character restarts output. All start/stop 
characters are ignored and not read. If IXANY is set, any input character 
restarts output which has been suspended. 


If IXOFF is set, the system transmits START/STOP characters when the input 
queue is nearly empty/full. 


The initial input control value is all-bits-clear. 


The c_oflag field specifies the system treatment of output: 


OPOST 
OLCUC 
ONLCR 
OCRNL 
ONOCR 
ONLRET 
OFILL 
OFDEL 
NLDLY 
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0000200 
0000400 
0 

0000400 
0003000 
0 

0001000 
0002000 
0003000 
0014000 
0 

0004000 
0010000 
0014000 
0020000 
0 

0020000 
0040000 
0 

0040000 
0100000 
0 

0100000 


Postprocess output. 

Map lowercase to uppercase on output. 
Map NL to CR-NL on output. 

Map CR to NL on output. 

No CR output at column 0. 

NL performs CR function. 

Use fill characters for delay. 

Fill is DEL, else NUL. 

Select new-line delays: 


Select carriage-return delays: 


Select horizontal-tab delays: 


Expand tabs to spaces. 


Select backspace delays: 


Select vertical-tab delays: 


Select form-feed delays: 
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If OPOST is set, output characters are post-processed as indicated by the 
remaining flags, otherwise characters are transmitted without change. 


If OLCUC is set, a lowercase alphabetic character is transmitted as the 
corresponding uppercase character. This function is often used in conjunction 
with IUCLC. 


If ONLCR is set, the NL character is transmitted as the CR-NL character pair. 
If OCRNL is set, the CR character is transmitted as the NL character. If 
ONOCR is set, no CR character is transmitted when at column 0 (first position). 
If ONLRET is set, the NL character is assumed to do the carriage-return 
function; the column pointer is set to 0 and the delays specified for CR are used. 
Otherwise the NL character is assumed to do just the line-feed function; the 
column pointer remains unchanged. The column pointer is also set to 0 if the 
CR character is actually transmitted. 


The delay bits specify how long transmission stops to allow for mechanical or 
other movement when certain characters are sent to the terminal. In all cases a 
value of 0 indicates no delay. If OFILL is set, fill characters are transmitted for 
delay instead of a timed delay. This is useful for high baud rate terminals which 
need only a minimal delay. If OFDEL is set, the fill character is DEL, otherwise 
NUL. 


If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 


New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage-return 
delays are used instead of the new-line delays. If OFILL is set, two fill 
characters are transmitted. 


Carriage-return delay type 1 is dependent on the current column position, type 2 
is about 0.10 seconds, and type 3 is about 0.15 seconds. If OFILL is set, delay 
type 1 transmits two fill characters, and type 2, four fill characters. 


Horizontal-tab delay type 1 is dependent on the current column position. Type 2 
is about 0.10 seconds. Type 3 specifies that tabs are to be expanded into spaces. 
If OFILL is set, two fill characters are transmitted for any delay. 


Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character is 
transmitted. 


The actual delays depend on line speed and system load. 
The initial output control value 1s all bits clear. 
The c_cflag field describes the hardware control of the terminal: 


Page 6 UP-14805 


TERMIO(7) 


0040000 


Baud rate: 


Hang up 
50 baud 
75 baud 
110 baud 
134 baud 
150 baud 
200 baud 
300 baud 
600 baud 
1200 baud 
1800 baud 
2400 baud 
4800 baud 
9600 baud 


19200 baud 
External A 
38400 baud 
External B 
Character size: 


5 bits 
6 bits 
7 bits 
8 bits 


Send two stop bits, else one. 
Enable receiver. 

Parity enable. 

Odd parity, else even. 

Hang up on last close. 
Local line, else dial-up. 


Block layer output. 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang 


up the connection. If BO is specified, the data-terminal-ready signal is not 


asserted. Normally, this disconnects the line. For any particular hardware, 
impossible speed changes are ignored. 


The CSIZE bits specify the character size in bits for both transmission and 
reception. This size does not include the parity bit, if any. If CSTOPB is set, 
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two stop bits are used, otherwise one stop bit. For example, at 110 baud, two 
stops bits are required. 


If PARENB is set, parity generation and detection is enabled and a parity bit is 
added to each character. If parity is enabled, the PARODD flag specifies odd 
parity if set, otherwise even parity is used. 


If CREAD Is set, the receiver is enabled. Otherwise no characters are received. 


If HUPCL 1s set, the line is disconnected when the last process with the line 
open closes it or terminates. That is, the data-terminal-ready signal is not 
asserted. 


If CLOCAL is set, the line is assumed to be a local, direct connection with no 
modem control. Otherwise modem control is assumed. 


If LOBLK is set, the output of a job control layer is blocked when it is not the 
current layer. Otherwise the output generated by that layer is multiplexed onto 
the current layer. 


The initial hardware control value after open is B300, CS8, CREAD, HUPCL. 


The c_iflag field of the argument structure is used by the line discipline to 
control terminal functions. The basic line discipline (0) provides the following: 


ISIG 0000001 Enable signals. 

ICANON 0000002 Canonical input (erase and kill processing). 
XCASE 0000004 Canonical upper/lower presentation. 
ECHO 0000010 Enable echo. 

ECHOE 0000020 Echo erase character as BS-SP-BS. 
ECHOK 0000040 Echo NL after kill character. 

ECHONL 0000100 Echo NL. 

NOFLSH 0000200 Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the special control 
characters INTR, SWTCH, and QUIT. If an input character matches one of 
these control characters, the function associated with that character is performed. 
If ISIG is not set, no checking is done. Thus these special input functions are 
possible only if ISIG is set. These functions may be disabled individually by 
changing the value of the control character to an unlikely or impossible value 


(e.g., 0377). 


If ICANON is set, canonical processing is enabled. This enables the erase and 
kill edit functions, and the assembly of input characters into lines delimited by 
NL, EOF, and EOL. If ICANON is not set, read requests are satisfied directly 
from the input queue. A read is not satisfied until at least MIN characters have 
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been received or the timeout value TIME has expired between characters. This 
allows fast bursts of input to be read efficiently while still allowing single 
character input. The MIN and TIME values are stored in the position for the 
EOF and EOL characters, respectively. The time value represents tenths of 
seconds. 


If XCASE is set, and if ICANON is set, an uppercase letter is accepted on input 
by preceding it with a \ character, and is output preceded by a \ character. In 
this mode, the following escape sequences are generated on output and accepted 
on input: 


for: use: 
Y v 
i: 
a 5a 
eM 
} )6\) 
\ MM 


For example, A is input as \a, \n as \\n, and \N as \\\n. 
If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are possible. If ECHO and 
ECHOE are set, the erase character is echoed as ASCII BS SP BS, which clears 
the last character from a CRT screen. If ECHOE is set and ECHO is not set, 
the erase character is echoed as ASCII SP BS. If ECHOK is set, the NL 
character is echoed after the kill character to emphasize that the line is deleted. 
Note that an escape character preceding the erase or kill character removes any 
special function. If ECHONL is set, the NL character is echoed even if ECHO 
is not set. This is useful for terminals set to local echo (so-called half duplex). 
Unless escaped, the EOF character is not echoed. Because EOT is the default 
EOF character, this prevents terminals that respond to EOT from hanging up. 


If NOFLSH is set, the normal flush of the input and output queues associated 
with the quit, switch, and interrupt characters is not done. 


The initial line-discipline control value is all bits clear. 
The primary ioctl(2) system calls have the form: 


ioctl (fildes, command, arg) 
struct termio *arg; 
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The commands using this form are: 


TCGETA Get the parameters associated with the terminal and store in the 
termio structure referenced by arg. 


TCSETA _ Set the parameters associated with the terminal from the structure 
referenced by arg. The change is immediate. 


TCSETAW Wait for the output to drain before setting the new parameters. 
This form should be used when changing parameters that affect 
output. 


TCSETAF Wait for the output to drain, then flush the input queue and set the 
new parameters. 


Additional ioctl(2) calls have the form: 


ioctl (fildes, command, arg) 
int arg; 
The commands using this form are: 


TCSBRK Wait for the output to drain. If avg is 0, then send a break 
(zero bits for 0.25 seconds). 


TCXONC _ Start/stop control. If arg is 0, suspend output; if 1, restart 
suspended output. 


TCFLSH If arg is 0, flush the input queue; if 1, flush the output queue; 
if 2, flush both the input and output queues. 


FILES 
/dev/tty* 


SEE ALSO 
stty(1) in the User’s Reference Manual 
fork(2), ioctl(2), setpgrp(2), signal(2) in the Programmer’s Reference Manual 
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. NAME 
| = timod - Transport Interface cooperating STREAMS module 


| DESCRIPTION 

The module timod is a STREAMS module for use with the Transport Interface 
(TI) functions of the Network Services library. The fimod module converts a set 
of ioctl(2) calls into STREAMS messages that may be consumed by a transport 
protocol provider which supports the Transport Interface. This allows a user to 
initiate certain TI functions as atomic operations. 


The timod module must be pushed (see Streams Primer) onto only a stream 
terminated by a transport protocol provider which supports the TI. 


All STREAMS messages, with the exception of the message types generated from 
the ioctl commands described below, are transparently passed to the neighboring 
STREAMS module or driver. The messages generated from the following ioctl 
commands are recognized and processed by the timod module. The format of 
the ioctl call is: 


™ #include <sys/stropts.h> 


struct strioctl strioctl; 
strioctlic_ cmd = cmd; 
strioctl.ic_ timeout = INFTIM; 
strioctl.ic len = size; 
strioctl.ic_ dp = (char *)buf 


ioctl(fildes, 1 STR, &strioctl); 


Where, on issuance, size is the size of the appropriate TI message to be sent to 
the transport provider and on return size is the size of the appropriate TI 
message from the transport provider in response to the issued TI message. buf 1S 
a pointer to a buffer large enough to hold the contents of the appropriate TI 
a messages. The TI message types are defined in <sys/tihdrh>. The possible 
| values for the cmd field are: 


TL BIND Bind an address to the underlying transport protocol provider. 
The message issued to the TI_BIND ioctl is equivalent to the 
TI message type T_BIND_REO and the message returned by 
the successful completion of the ioctl is equivalent to the TI 
message type T_ BIND_ACK. 
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TI_UNBIND 


TI_GETINFO 


TIl_OPTMGMT 


FILES 
< sys/timod.h> 
< sys/tiuser.h > 
< sys/tihdr.h > 
< sys/errno.h> 


SEE ALSO 
tirdwr(7) 


Unbind an address from the underlying transport protocol 
provider. The message issued to the TI_ UNBIND ioctl is 
equivalent to the TI message type T UNBIND_REQ and the 
message returned by the successful completion of the ioctl is 
equivalent to the TI message type T OK_ACK. 


Get the TI protocol specific information from the transport 
protocol provider. The message issued to the TI GETINFO 
ioctl is equivalent to the TI message type T INFO_REQ and 
the message returned by the successful completion of the ioctl 
is equivalent to the TI message type T INFO ACK. 


Get, set or negotiate protocol specific options with the 
transport protocol provider. The message issued to the 
TIOPTMGMT ioctl is equivalent to the TI message type 
T_OPTMGMT_REQ and the message returned by the 
successful completion of the ioctl is equivalent to the TI 
message type T OPTMGMT_ ACK. 


STREAMS Primer 
STREAMS Programmer’s Guide 
Network Programmer’s Guide 


DIAGNOSTICS 


If the ioct/ system call returns with a value greater than 0, the lower 8 bits of the 
return value are one of the TI error codes as defined in <sys/tiuser.h>. If the 
TI error is of type TSYSERR, then the next 8 bits of the return value contain an 
error as defined in <sys/ermo.h > [see intro(2)]. 
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NAME 
tirdwr - Transport Interface read/write interface STREAMS module 


DESCRIPTION 
The module tirdwr is a STREAMS module that provides an alternate interface to 
a transport provider which supports the Transport Interface (TI) functions of the 
Network Services library (see Section 3N). This alternate interface allows a user 
to communicate with the transport protocol provider using the read(2) and 
wnite(2) system calls. The putmsg(2) and getmsg(2) system calls may also be used. 
However, putmsg and getmsg can only transfer data messages between user and 
Stream. 


The firdwr module must only be pushed [see I PUSH in streamio(7)] on to a 
Stream terminated by a transport protocol provider which supports the TI. After 
the tirdwr module has been pushed on to a Stream, none of the Transport 
Interface functions can be used. Subsequent calls to TI functions cause an error 
on the Stream. Once the error is detected, subsequent system calls on the 
Stream return an error with emo set to EPROTO. 


| \ The following are the actions taken by the frdwr module when pushed on the 
| Stream, popped [see I_POP in streamio(7)] off the Stream, or when data passes 
through it. 


push - When the module is pushed on to a Stream, it checks any existing 
data destined for the user to ensure that only regular data messages 
are present. It ignores any messages on the Stream that relate to 
process management, such as messages that generate signals to the 
user processes associated with the Stream. If any other messages are 
present, the I_ PUSH returns an error with evmo set to EPROTO. 


write - The module takes the following actions on data that originated from 
a write system call: 


- All messages with the exception of messages that contain control 
portions (see the putmsg and getmsg system calls) are 
transparently passed on to the module’s downstream neighbor. 


- Any zero length data messages are freed by the module and they 
rr are not passed on to the module’s downstream neighbor. 


- Any messages with control portions generate an error, and any 
further system calls associated with the Stream fail with evmo set 
to EPROTO. 


UP-14805 Page 1 


TIRDWR (7) 


read - The module takes the following actions on data that originated from 
the transport protocol provider: 


All messages with the exception of those that contain control 
portions (see the putmsg and getmsg system calls) are 
transparently passed on to the module’s upstream neighbor. 


The action taken on messages with control portions is as follows: 


+ Messages that represent expedited data generate an error. 
All further system calls associated with the Stream fail with 
ermo set to EPROTO. 


+ Any data messages with control portions have the control 
portions removed from the message prior to passing the 
message on to the upstream neighbor. 


+ Messages that represent an orderly release indication from 
the transport provider generate a zero length data message, 
indicating the end of file, which are sent to the reader of 
the Stream. The orderly release message itself is freed by 
the module. 


+ Messages that represent an abortive disconnect indication 
from the transport provider cause all further write and 
putmsg system calls to fail with ermo set to ENXIO. All 
further read and getmsg system calls return zero length data 
(indicating end of file) once all previous data has been read. 


+ With the exception of the above rules, all other messages 
with control portions generate an error and all further 
system calls associated with the Stream fail with evmo set to 
EPROTO. 


Any zero length data messages are freed by the module and they 
are not passed on to the module’s upstream neighbor. 


pop - When popping the module off or closing the Stream, the module 
takes the following actions: 
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If an orderly release indication has been previously received, then 
an orderly release request is sent to the remote side of the 
transport connection. 


If an abortive disconnect has been previously received, then no 
action is taken. 
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- If neither an abortive disconnect nor an orderly release have been 
“™ previously received, an abortive disconnect is initiated by the 
| module. 


- If an error has occurred previously and an abortive disconnect 
has not been previously received, an abortive disconnect 1s 
initiated by the module. 


SEE ALSO 
streamio(7), timod(7) 
intro(2), getmsg(2), putmsg(2), read(2), write(2), intro(3) in the Programmer’s 
Reference Manual 
STREAMS Primer 
STREAMS Programmer’s Guide 
Network Programmer’s Guide 
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J NAME 
oc” tp - driver for QIC-02 5.25 inch streaming tapes 


DESCRIPTION 
Only one type of streaming tape drive should be configured per system as the 
| recording formats differ between the drives. 


The maximum configuration of the 5.25 streaming tape units is two units per 
controller. 


Information regarding vector number, Multibus I/O address, and strapping on the 
controller can be obtained by running show(1M). 


The following shows the actual amount of data that a 45 MB streaming tape 
cartridge can hold: 


Streaming tape cartridge Size 


Unformatted capacity 45 MB 
los Formatted capacity 43,740,000 bytes 


| MINOR NUMBER 
Unit number, controller ID and rewind on close are encoded in the minor 
number. The minor number as an 8 bit field is as follows: 


Bit(s) Description 

0-1 unit number 0-3 

2 = 0 rewind on close 
= 1 no rewind on close 

3 = 0 rewind on open 
= 1 no rewind on open 

4 controller ID 0-1 

5-6 unused 

7 this node permits reading of tapes created on an 8 
inch drive to be read on the 5.25 tape drive 
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IOCTL SYSTEM CALLS 
Five toctl system calls are available. The cmd portion of the call is as follows: 


cmd Description 
1 retension tape 
2 erase tape 
3 condition tape (erase then retension) 
4 set new logical tape size [default is 80000 blocks 
(512 bytes)]; avg passed is a pointer to an int 
containing the new size in blocks 
5 read maximum size of tape 
WARNINGS 


It is suggested that the tape should be retensioned before each use as this may 
decrease the number of read/write errors encountered on the tape. 


If you plan to use the system administrator menus to backup files, make the disk 
partition slightly smaller than the backup media you are using. The Systemn 
Administrator backup procedure automatically adds check sum information to the 
backup media. 


FILES 
/dev/nnrtp 
/dev/nyrtp 
/dev/nrtp 
/dev/rtp 
/dev/rstp/* 
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NAME 
trace - event-tracing driver 


DESCRIPTION 
The file trace is a special file that allows event records generated within the 
UNIX system kernel to be passed to a user program so that the activity of a 
driver or other system routines can be monitored for debugging purposes. 


An event record is generated from within a kernel driver or system routine by 
invoking the trsave function: 


trsave (dev, chno, buf, cnt) 
char dev, chno, *buf, cnt; 


Dev is a minor device number of the trace driver; chno is an integer between 0 
and 15 inclusive that identifies the data stream (channel) to which the record 
belongs; buf is a buffer containing the data for an event; and cnt is the number of 
bytes in buf. Calls to trsave result in data being placed on a queue provided that 
some user program has opened the trace minor device dev and has enabled 
channel chno. Event records consisting of a time stamp (4 bytes), the channel 
number (1 byte), the count (1 byte), and the event data (cnt bytes) are stored on 
a queue until a system-defined maximum (TRQMAX) is reached; an event 
record is discarded if there is not sufficient room on the queue for the entire 
record. The queue is emptied by a user program reading the trace driver. Each 
read returns an integral number of event records; the read count must, therefore, 
be at least equal to cnt plus six. 


The trace driver supports open, close(2), ioctl(2), and read(2) system calls. The 
ioctl system call is invoked as follows: 


#include <sys/vpm.h> 
int fildes, cmd, arg; 
ioctl (fildes, cmd, arg); 
The values for the cmd argument are: 


VPMSETC-Enable trace channels. This command enables each channel 
indicated by a 1 in the bit mask found in avg. The low-order bit (bit 0) 
corresponds to channel zero, the next bit (bit 1) corresponds to channel 


‘™~ 1, etc. 


VPMGETC-Get enabled channels. This command returns in arg a bit mask 
containing a 1 for each channel that is currently enabled. 
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VPMCLRC-Disable channels. This command disables the channels indicated by 
a 1 in the bit mask found in arg. 


SEE ALSO YO 
close(2), ioctl(2), open(2), read(2) in the Programmer’s Reference Manual 
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NAME 
tty - controlling terminal interface 


DESCRIPTION 
The file /dev/tty is, in each process, a synonym for the control terminal associated 
with the process group of that process, if any. It is useful for programs or shell 
sequences that wish to be sure of writing messages on the terminal no matter how 
output has been redirected. It can also be used for programs that demand the 
name of a file for output, when typed output is desired and it is tiresome to find 
out what terminal is currently in use. 


FILES 
/dev/tty 
/dev/tty* 


SEE ALSO 
ports(7) 
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NAME 
wd - driver for the ST506 disks 


DESCRIPTION 
The hardware configuration of the ST506 disks consists of one disk controller 
and as many as four 5.25 inch and/or 3.50 inch disk drives. Any combination of 
disk drives is permitted as long as no more than two Winchester and two floppy 
disk drives are used. 


Winchester disks are formatted according to the type of disk as determined by 
format(1M). The format information is then read from block 0 of the disk by the 
driver during start-of-day processing to configure the controller/driver. 


Information regarding vector number, Multibus I/O address, and strapping on the 
controller can be obtained by running show(1M). 


Winchester Disk Partitions 
Winchester disks can be partitioned. Partitioning permits the user to divide one 
physical disk into several logical disks. To the driver, a partition appears to be a 
discrete physical device. All I/O requests are range checked to ensure that they 
reside entirely within the partition specified by the minor number. 


Partitions are defined by dkpart(1M). The driver reads the partition table from 
the disk(s) during start-of-day processing. The partition being referenced is 
determined by bits 2-5 of the minor number. The maximum number of partitions 
permitted per unit is sixteen. 


Minor Numbers 
Units 0 and 1 are ST506 Winchester disks and units 2 and 3 are SA400 floppy 
disks. Considered as an eight bit number, bits 2-5 of the minor number define 
the partition and bits 0-1 define the unit for Winchester disks. 


The format of the floppy disks is determined by bits 7-4 of the minor number. 
The definition of the minor number for floppy disks is: 


Bit 7 Number of heads; 0 - 2 heads, 1 - 1 head 

Bit 6 Sector size; 0 - 512 byte sectors, 1 - 256 byte sectors 

Bit 5 Tracks per inch; 0 - 96, 1 - 48 

Bit 4 Sectors per track; 0 - eight 512 byte sectors or sixteen 256 


byte sectors, 1 - nine 512 byte sectors or invalid if 256 byte 
sectors (bit 4 = 1 not supported for floppy disk) 
Bits 3-2 Not used 


UP-14805 Page 1 


WD(7) | 
a a eg 


Bits 1-0 Unit number; 00 - Winchester unit 0 (h501), 01 - Winchester 
unit 1 (h502), 10 - Floppy unit 0 (£501), 11 - Floppy unit 1 
(£502) 


Caution: If a disk is written in the 48 tracks per inch mode with a 96 tracks per 
inch drive, readability on a 48 tracks per inch drive exhibits a higher soft error 
rate and, in some cases, unrecoverable data errors because of the narrower track 
width of the 96 tracks per inch drive. 


Alternate Block Handling 
The disk controller can manage a maximum of 128 flawed sectors per unit. With 
the high capacity ST506 disks, 128 alternates may not always be sufficient. The 
driver manages any excess flawed sectors up to a maximum of 512 sectors. The 
sectors are marked as defective and the bad block table is constructed by 
format(1M). During start of day processing, the driver issues the first 128 flawed 
sector numbers to the controller and maintains a list of any excess flawed sector 
numbers in memory. If a flawed sector is accessed by the driver and the 
corresponding alternate is not in the controllers list, an error completion code is 
generated by the controller. The driver, upon encountering this unique error 
code, scans the in memory list for the alternate and completes the operation. 


Overlapping Seeks 
Overlapping seeks are implemented in the following manner. If both Winchester 
disks are ready at start of day, a queue selection algorithm capable of generating 
overlapping seeks is selected; otherwise the selection of the next request is done 
round-robin with priority given to the Winchester disks. In the first case the 
driver keeps track of the present cylinder of each unit and issues an explicit seek 
command to the unit which has the longest seek distance if I/O requests are 
pending for both Winchester disks. In the case of an equal distance, unit 0 gets 
the explicit seek. 


FILES 
/dev/dsk/[0-1]s[0-f] 
/dev/rdsk/[0-1]s[0-f] 
/dev/fdsk/[0-1]s[0-f] 
/dev/rfdsk/[0-1]s[0-f] 


SEE ALSO 
dkpart(1M), format(1M), mknod(1M), newfs(1M), verify(1M) 
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NAME 
a \ xl - driver for the 8 inch Winchester disks 


DESCRIPTION 
The hardware configuration of the 8 inch Winchester disks consists of one two- 
board or one one-board SMD disk controller and as many as four 8 inch SMD- 
compatible disk drives. The x/ driver supports only 8 inch SMD disk drives 
which have been successfully formatted by format(1M). The x/ driver supports 
power fail recovery, error logging, retries on I/O errors, in-service diagnostics, 
and special I/O control (ioctl) system functions. 


Information regarding vector number, Multibus I/O address, and strapping on the 
controller can be obtained by running show(1M). 


PARTITIONING 
The available disk space may be divided, or partitioned, where each partition 
looks like a logical device to the operating system. Such partitioning is useful for 
dividing up the operating file system into mountable logical units. 


a \ The partition boundaries and sizes are defined in the table xl_sizes which is 
linked with the driver software. Each table entry contains an entry for the 
partition size (in 512 byte sectors) and the absolute sector number of the first 
sector in the partition. 


Partitions may be defined arbitrarily as long as they stay within the operating 
system available space (i.e. file system area) and do not overlap another partition. 
Partition 0 is reserved for use as the entire physical device; partition 1 generally 
refers to the file system which would exist on the device if the entire file system 
area of the device were used as a single partition. Partition 15 of the device is 
reserved for the swap area on the device if the device is specified as a swap 
device. 


A defined partition table looks like this : 


struct xlsiztab { 
longnblocks; 
longblkoff; 
ce” } xL_size [] = {131936, 0, /* partition 0 - whole disk access */ 
! 130816, 0, /* partition 1 - file system area */ 
130816, 0, 
130816, 0, 
130816, 0, 
130816, 0, 
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130816, 0, 
130816, 0, 
130816, 0, 
130816, 0, 
130816, 0, 
130816, 0, 
130816, 0, 
130816, 0, 
130816, 0, 
8000, 122816 }; /* partition 15 - swap partition */ 


This table is defined in the system include file io.h which is included into the 
operating system conf.c configuration file. It must be configured before the 
kernel is generated and may not be changed dynamically. 


The subsystem determines which of the physical drives to access and which drive 
partition to use from the minor number passed to it for each I/O request. The 
minor number is an encoded 8 bit binary number defined as: 


Bits 7-6 0 
Bits 5-2 Partition number; 0-15 
Bits 1-0 Physical drive number; 0-3 


The logical device node used to access a partition on a physical unit is created 
with the major number for the disk driver and the minor number as defined 
above. The major number is used to access the driver and the minor number 
determines the physical device and partition to access. 


DISK AREAS | 
The available media space is organized into the following areas, the actual 
locations of which may vary, being determined by format(1M). 


Boot Block Area 
The first sector on each physical drive contains the boot block structure. This 
structure is used for the firmware boot, firmware and inservice diagnostics, and 
for drive identification. The disk sector address of the bad block table, first 
alternate block, Intermediate System Loader (ISL) object file start sector and 
length, and maintenance area are contained in this structure along with drive 
identification information. 


File System Area 
The file system area is the space made available for use by the operating system. 
The space can be partitioned into logically separate units. 
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Alternate Block Area 

cf” This area contains the data blocks which have been assigned as alternates for 
blocks from within the file system(s) which have been logged as bad blocks. 
Once an alternate block has been assigned to an unusable block during 
formatting, every subsequent access to the bad block generates an access to the 
assigned alternate in the x/ disk driver; this access is transparent to software 
outside the driver, but if many bad blocks exist on a given device, this transparent 
access may be noticeable in terms of reduced performance. 


Before any operations are done to a device, the Bad Block Table is read into 
memory within the driver at start-of-day. When a block read or write is done to 
the physical unit this table is scanned and if the sector is logged in the table its 
alternate is calculated as the bad block table entry offset plus the base address of 
the bad block table. This sector is then used for the I/O. 


ISL Loader Area 
Following the Alternate Sector Area is the ISL Loader Area. The ISL Loader 
object is stored here for access by the start up subsystem at system load time. 
o™ The ISL object is loaded by the firmware and is used to load in the operating 
| ) system object at boot time. 


Reserved Area 
The last cylinder on the media is reserved for diagnostic functions. The start up 
subsystem diagnostics and in-service diagnostics use this cylinder for testing the 
device. 


RESTRICTIONS 
Read after write checking is supported for block I/O only. The transfer of less 
than 512 bytes is not supported; the partial block is not transferred and the 
number of bytes not transferred is stored in bp.resid. 


Only an interleave factor of 1:1 is supported. 
FILES 


/dev/dsk/[2-5]s[0-f] 
/dev/rdsk/[2-5]s[0-f] 


cf” SEE ALSO 


format(1M), verify(1M), badlist(1M), dkpart(1M), newfs(1M), btblock(1M) 
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NAME 
intro - introduction to system maintenance procedures 


DESCRIPTION 
This section describes various procedures for those charged with system 
maintenance. 
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NAME 
o™ boot - startup procedure 


DESCRIPTION 
The bootload sequence loads the operating system into memory from the disk 
load device in two steps: the first step is carried out by the Load Supervisor and 
the second step is carried out by the Intermediate System Loader (ISL). The 
Load Supervisor resides in firmware and the ISL resides on disk. 


The Load Supervisor provides an interface for the user through startup [sus(8)] 
by supporting four functions: auto load, interactive load, install, and streaming 
tape load. 


1) The auto load function performs an automatic bring-up of the system upon 
powering up the unit; requiring no operator intervention once the unit is 
turned on. This function is selected if the switch setting on the Processor 
Memory Controller in the main unit is set to auto. Once loaded, control is 
passed to the operating system. 


o™ 2) The interactive load function is selected if the Processor Memory 

| Controller switch in the main unit is set in the manual position, and 
requires the operator to specify the device from which to load and the file 
to load. This is done from the startup menu displayed to the terminal. This 
function allows the user to load files other than the operating system (e.g. 
diagnostics or standalone utilities) provided they conform to standard load 
file format. Once the file is loaded, control may be returned selectively to 
the startup menu, or to the loaded program. 


The load device is specified by a four-character device name which 
uniquely identifies that device to the Load Supervisor. The first two 
characters are the type of load device (whether a floppy disk, Winchester 
disk, or SCSI disk); the last two characters are the unit number. The load 
device names are: 
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ST506 Disk Controller 
Floppy disk devices 
Hard disk devices 


Small Computer System Interface (SCSI) 
External SCSI disk 
Hard disk devices 
Internal SCSI disk 
Hard disk devices 
Floppy disk devices 


£501-f502 
h501-h502 


sd01-sd34 


sdal, sdb1 
sfd1, sfd2 


The load file is specified by its pathname, which is a description of where 
the file to be loaded is located in the file system on the load device. The 
operating system pathname is /unix. This is the file loaded during auto-load; 
in the interactive-load sequence, it must be specified in the form as 
indicated above. 


3) The install function is similar to the interactive load function in that it is 
also accessed from the startup menu, but it is used exclusively to bring in 
the system installation procedures from removable media. 


Although there are three functions for loading, the load process itself is the same. 
Once the user has initiated the particular load function, the Load Supervisor 
reads in the ISL from the load device specified. In order to load the system (ora 
related utility), a copy of the ISL must reside on the disk which is the selected 
load device. Information regarding the location of the ISL on the disk is 
contained in the first sector of the disk, the bootblock. The Load Supervisor 
reads the bootblock to determine where to find the ISL. Once the ISL is loaded, 
control is passed from the Load Supervisor to the ISL. 


It is the task of the ISL to search the file system on the specified disk device for 
the particular file to be loaded, and load the file if it is found, or else report an 
error. 


4) Loading from streaming tape may be selected with the interactive load 
function or the install function. The load device names are: 


Streaming Tape Controller 
Tape device st01 

Small Computer System Interface (SCSI) 
External tape devices 

Internal tape devices 


ss61, ss51 
ssgl, ssf1 
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The user can not specify the load file; the first file after the boot block is 
aN loaded. Level-1 diagnostics may be loaded by this function. 


Errors may occur in the course of bootloading, and may be detected by either the 
Load Supervisor or the ISL. Refer to the Error Message Manual. 


FILES 
/unix - system code 


SEE ALSO 
sus(8) 
a.out(4), dir(4) in the Programmer’s Reference Manual 
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™ NAME 


inserv - inservice diagnostics 


SYNOPSIS 
inserv (id_name,recbuf) 
char *id_name, *recbuf; 


DESCRIPTION 
The command inserv is a mechanism through which the inservice diagnostic 
service routines may be invoked. The list of diagnostics which the operating 
system knows about is determined during system configuration. Only the system 
administrator, superuser, or Unisys-trained technician may use this function. 


Before invoking the inserv function the appropriate device name must be supplied 
(by way of the character string pointer id_name). The data record (id_rec) 
contains control and amplifying data. The interpretation of the control and data 
record must be mutually agreed upon with the diagnostic service routine. 


o™ inserv only verifies the invoker’s authenticity and then dispatches the inservice 
| s diagnostic request to the appropriate diagnostic routine. 


DIAGNOSTIC(S) 
inserv returns a -1 on invocation error conditions. The external variable ermo 
contains a value indicative of the error type. EACCES is returned when an 
attempt to invoke inserv by an unauthorized individual is made. If the selected 
device has no diagnostic service routine ENXIO is returned. Other error values 
may be returned at the discretion of each diagnostic service routine. 


UP-14805 Page 1 


a —eeeeeaeaewTTssETeeeaea SET See 


INSERV(8) 
a eg ge 


[This page left blank.] 


Page 2 UP-14805 


LODIAG(8) 


NAME 
l0diag - perform automatic level 0 diagnostics 


DESCRIPTION 
Automatic (level 0) diagnostics are performed by the ROM resident SUS (Start 
Up Subsystem) upon application of power or a system reset. These diagnostics 
test the functions necessary for proper bring-up of the system. These diagnostics 
may also be invoked in the manual mode. 


The output to a system console during these diagnostics is shown in the example 
below. 


AUTO TEST SEQUENCE 
TEST: IVT TOD EDC MMU MEM OCT DKS5 SMD STP MPA 


IVT - hardware Interval Timer diagnostic 
TOD - hardware Time Of Day diagnostic 
EDC - memory Error Detection and Correction diagnostic 
MMU - Memory Management Unit diagnostic 
c™ MEM - Memory diagnostic 
OCT - 8-Channel I/O Controller diagnostic 
DKS - 5.25 Inch Disk Controller diagnostic (floppy and Winchester) 
SMD - Storage Module Drive Controller diagnostic 
STP - Streaming Tape Controller diagnostic 
MPA - Multi-Protocol Communication Controller diagnostic 


The test names that are actually displayed may not include all of the names 
shown. The test names that appear depend on the system configuration. 


The level 0 diagnostics can be invoked in the manual mode. The procedure 
necessary for this is outlined below. 


. Set the auto/manual switch in the manual position. 
. Toggle the reset switch or turn power off then on. 
. Select the TEST option from the SUS menu. 

. Select TEST LOOP from the TEST menu. 

. Follow instructions for looping on diagnostics. 


M&W Ne 


The output to a system console during looping on level 0 diagnostics is shown in 
the example below. 


LOOP i 
FAILURE COUNT j 
TEST: IVT TOD EDC MMU MEM OCT DK5 SMD STP MPA 
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where: 
1 = the current loop number 
j = cumulative failure count 


There are two methods for terminating the looping on the level 0 diagnostics. 
The first method is to move the auto/manual mode switch to the manual mode 
position. The second method is to press any key on the input device. Each of 
these methods results in the termination of the looping process at the end of the 
test loop in progress. Because of the exiting of the looping process at the end of 
a test loop, the following note must be made about the second method of exiting 
the looping process. Although the actual key pressed does not matter, the timing 
of pressing the key is important. The key must be pressed after the OCT 
diagnostic and before the end of the test loop in progress. This is due to the 
nature of the OCT diagnostic. The diagnostic resets I/O channels and they must 
be reinitialized in order to recognize the key depression. 


SEE ALSO 
sus(8) 
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o™ NAME 
| sus - startup procedure 


DESCRIPTION 
There are two modes of startup: auto and interactive. The auto sequence includes 
system initialization, testing, and either loading or returning to a previously 
loaded system (power failure recovery). The interactive sequence is a collection 
of menu driven user utilities. The startup procedure is initialized when power is 
applied to the system. 


Auto - With the auto/manual switch in the auto position, a system reset 1s 
performed. Startup searches for a "warm" string to determine if the system has 
previously been loaded. If found, then a warm start is initiated; otherwise, a cold 
start is initiated. For cold starts, memory is sized, tested, and initialized. Base 
hardware present is tested and the operating system is loaded. For warm starts, 
the memory map (created during the last cold start) is examined and the memory 
specified is tested non-destructively. If the memory is good, then execution passes 
to the power failure recovery address specified by the operating system. 


Interactive - With the auto/manual switch in the manual position, a system reset 
is performed. Startup performs cold or warm initialization only (see auto 
description) and displays the basic startup subsystem (SUS) menu of the 
following functions: 


QUERY Error Log and General Purpose Support utilities 
INSTALL System Software Installation utility 
LOAD Interactive Loading utility 
SWITCH INPUT Floating Console Switch (deselects master console) 
TEST Diagnostic utilities 
SUSBUG Read, Write, Go Monitor 
SEE ALSO 
boot(8), 10diag(8) 
TaN Hardware Service book 
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NAME 
suscmd - invoke Start-Up-Subsystem function 


SYNOPSIS 
suscmd (addr) 
char *addr; /* Function sles ny 


DESCRIPTION 
The command suscmd executes the Start-Up-Subsystem function at address addr. 
Only the superuser or a Unisys-trained technician may use this function. 


DIAGNOSTIC(S) 
suscmd returns a -1 on invocation error. 


The external variable ermo contains a value indicative of the error type. 
EACCES 1s returned when an attempt to invoke sus/og by an unauthorized 
individual is made. 


RESTRICTIONS ) 
Great care should be given in using this routine as it allows direct access to many 
kernel functions, 1.e., it bypasses protection mechanisms normally provided by 
various library routines. 
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NAME 
suslog - invoke Start-Up-Subsystem (SUS) log driver 


SYNOPSIS 
#include <sys/suslog.h> 


suslog (seldp, rbufp, bufsize) 

struct seld_t *seldp; /* SUS log driver iobp */ 
char *rbufp; /* Error record 3 
int bufsize; /* Error record size */ 


char rbuf[BUFSIZE], rbufp = &rbuf; 


DESCRIPTION 
The command suslog provides controlled access to the Start-Up-Subsystem error 
log. Only the superuser or a Unisys-trained technician may use this function. 


It is recommend that the error log buffer be at least 255 bytes in size for all find 
and read operations. The maximum size of an error record from the SUS driver 
on single record find/reads is 255. rbufp is the location into which no more than 
bufsize bytes of an error record are placed. se/dp points to a structure which must 
contain FDREC in the sd_func field and 0 in the sd_erp field to specify the first 
record of the SUS error log. The sd_erp field contains the proper address for 
reading the next error record after each successful read or find operation. On 
write (log) record operations the size of your error record to log should be 
placed in bufsize. The size field of the SUS interface record is changed to this 
value. rbufp is the location of bufsize bytes of an error record to write in the error 
log. seldp points to a record which must contain LOGEREC in the sd_func field. 
Other fields in the structure are not used for write error log operations. 


DIAGNOSTICS 
suslog returns a -1 on invocation error conditions; otherwise the SUS log pass/fail 
value. 


The external variable ermo contains a value indicative of the error type. 

EACCES is returned when an attempt to invoke suslog by an unauthorized 
individual is made. EBUSY is returned whenever the log driver is already 
opened or the driver is currently logging an error. = a necessary buffer pointer is 
NULL, ermo contains EFAULT. 
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